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)
- Parâmetros (Obrigatórios):
Response Body
JSON{ "formattedAddress": "String", "city": "String", "state": "String", "country": "String" }
- GET- https://agro.totvs.app/api/v1/services/maps/geocode
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.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas