Calcular a distância entre duas coordenadas
/tools/location_distanceCalcula 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.
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'
const resposta = await fetch('https://app.nextagsai.com.br/api/tools/location_distance', {
method: 'POST',
headers: {
'X-ACCESS-TOKEN': process.env.NEXTAGS_API_KEY,
},
body: new URLSearchParams({
source_latitude: -23.5614,
source_longitude: -46.6559,
destination_latitude: -23.5505,
destination_longitude: -46.6333,
}),
});
const dados = await resposta.json();
console.log(resposta.status, dados);
import os
import requests
resposta = requests.post(
"https://app.nextagsai.com.br/api/tools/location_distance",
headers={"X-ACCESS-TOKEN": os.environ["NEXTAGS_API_KEY"]},
data={
"source_latitude": -23.5614,
"source_longitude": -46.6559,
"destination_latitude": -23.5505,
"destination_longitude": -46.6333,
},
timeout=30,
)
print(resposta.status_code, resposta.json())
<?php
$ch = curl_init('https://app.nextagsai.com.br/api/tools/location_distance');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'X-ACCESS-TOKEN: ' . getenv('NEXTAGS_API_KEY'),
],
CURLOPT_POSTFIELDS => http_build_query([
'source_latitude' => -23.5614,
'source_longitude' => -46.6559,
'destination_latitude' => -23.5505,
'destination_longitude' => -46.6333,
]),
]);
$dados = json_decode(curl_exec($ch), true);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), PHP_EOL;
print_r($dados);
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órioA latitude do ponto de partida, com ponto decimal (-23.5614).
source_longitudenumberobrigatórioA longitude do ponto de partida (-46.6559).
destination_latitudenumberobrigatórioA latitude do destino.
destination_longitudenumberobrigatórioA longitude do destino.
googleMapsApiKeystringOpcional: uma chave da API do Google Maps. Com ela, a distância é calculada pelo Google Maps.
Respostas
A distância, em metros e em milhas.
metersnumberA distância em metros.
milesnumberA distância em milhas.
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.