Pular para o conteúdo
Acessar conta

Calcular a distância entre duas coordenadas

POST/tools/location_distance
Gerada do contrato OpenAPI

Calcula a distância entre dois pontos de latitude e longitude, em metros e em milhas. Use para saber se o contato está na área de entrega ou para calcular o frete a partir da localização que ele mandou (Pedir e enviar localização). Com uma chave da API do Google Maps em googleMapsApiKey, o cálculo é feito pelo Google Maps.

Requisição
curl -X POST "https://app.nextagsai.com.br/api/tools/location_distance" \
  -H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY" \
  --data-urlencode 'source_latitude=-23.5614' \
  --data-urlencode 'source_longitude=-46.6559' \
  --data-urlencode 'destination_latitude=-23.5505' \
  --data-urlencode 'destination_longitude=-46.6333'

Autenticação

Mande a chave de API da conta no cabeçalho X-ACCESS-TOKEN de cada chamada. Veja Autenticação com a chave de API.

Corpo da requisição

FormulárioContent-Type: application/x-www-form-urlencoded

source_latitudenumberobrigatório

A latitude do ponto de partida, com ponto decimal (-23.5614).

source_longitudenumberobrigatório

A longitude do ponto de partida (-46.6559).

destination_latitudenumberobrigatório

A latitude do destino.

destination_longitudenumberobrigatório

A longitude do destino.

googleMapsApiKeystring

Opcional: uma chave da API do Google Maps. Com ela, a distância é calculada pelo Google Maps.

Respostas

200Sucesso

A distância, em metros e em milhas.

metersnumber

A distância em metros.

milesnumber

A distância em milhas.

401Chave inválida

A chave de API não veio no cabeçalho ou não vale (foi excluída ou está incompleta). Veja Autenticação.

Relacionados

Este conteúdo ajudou?

Obrigado! Sua resposta ajuda a melhorar a central.