TOTVS AGRO

Páginas filhas
  • Reverse Geocode - Busca por Latitude e Longitude

TOTVS Agro Plataforma - Busca por Latitude e Longitude via API

  • Requisição

    • GET- https://agro.totvs.app/api/v1/services/maps/geocode
      • Parâmetros (Obrigatórios):
        • latlng: Informar a latitude e longitude separado por vírgula. Exemplo: -20.660435,-53.418781 
        • appId: Informar o valor respectivo com código do produto. (Consultar com Engenharia TOTVS Agro)
        • tcode: Informar o TCODE do cliente. (Consultar com Equipe TOTVS)

    • Response Body

      JSON
      {
  "formattedAddress": "String",
  "city": "String",
  "state": "String",
  "country": "String"
}

  • Exemplo de Requisição

    • GET- https://agro.totvs.app/api/v1/services/maps/geocode?latlng=-22.660435,-50.418781&appId={appId_value}&tcode={tcode_value}

    • Response Body

      JSON
      {
    "formattedAddress": "Ribas do Rio Pardo, Mato Grosso do Sul, Brasil",
    "city": "Ribas do Rio Pardo",
    "state": "Mato Grosso do Sul",
    "country": "Brasil"
}

Mais informações sobre a API de Geolocalização

  • OpenStreetMap Nominatim

    • O TOTVS Agro Plataforma utiliza a API pública do OpenStreetMap Nominatim para realizar buscas de dados geográficos e retornar as informações correspondentes. Para mais detalhes, consulte a documentação oficial: OpenStreetMap Nominatim Documentation.

  • Coordenadas Geográficas em Graus Decimais (Latitude e Longitude)

    • Por padrão, o TOTVS Agro Plataforma utiliza três casas decimais para a precisão na busca de resultados geográficos. Isso significa que, independentemente do número de casas decimais fornecido nos parâmetros, apenas as três primeiras serão consideradas.

  • Caching de Dados

    • O TOTVS Agro Plataforma implementa um sistema de caching para armazenar os dados de consultas geográficas. Quando uma API é chamada pela primeira vez, uma requisição é enviada ao OpenStreetMap Nominatim para obter as informações necessárias. Em chamadas subsequentes, se os mesmos parâmetros de latitude e longitude forem utilizados, a resposta será obtida do cache, proporcionando uma melhoria no desempenho.

  • Limite de requisições por segundos

    • A API do TOTVS Agro Plataforma possui um limite de 100 requisições por segundo. Caso esse limite seja excedido, a API retornará o status 429 "Too Many Requests". É importante notar que o OpenStreetMap Nominatim possui um limite de uma requisição por segundo. Portanto, quando há muitos usuários simultâneos utilizando o serviço de geocode, pode haver um aumento no tempo de resposta.
  • Sem rótulos