Este documento o guiará pelos diferentes parâmetros de solicitação e resposta da API Distance Matrix e como você pode extrair dados análogos ao serviço Google Distance Matrix da API Distance Matrix com a mesma precisão, mas por um preço mais acessível e justo.
Pedido de Matriz de Distância
Google:
GET
https://maps.googleapis.com/maps/api/distancematrix/json?origins=<origin_location_1|origin_location_2|...|origin_location_n>&destinations=<destination_location_1|destination_location_2|...|destination_location_n>&key=<your_access_token>
https://api.distancematrix.ai/maps/api/distancematrix/json?origins=<origin_location_1|origin_location_2|...|origin_location_n>&destinations=<destination_location_1|destination_location_2|...|destination_location_n>&key=<your_access_token>
Exemplo de pedido da Matriz de Distância
Google:
GET
https://maps.googleapis.com/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=Westminster Abbey, Westminster, London SW1P 3PA, UK&key=<your_access_token>
https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=Westminster Abbey, Westminster, London SW1P 3PA, UK&key=<your_access_token>
Parâmetros obrigatórios e de resposta
Os parâmetros em uma solicitação (parte do URL) são os mesmos nos dois casos:
- lista de locais de origem (<longitude, latitude> coordenadas ou endereço do local de origem) separados pela barra vertical “|”).
- lista de locais de destino (<longitude, latitude> coordenadas de localização de origem ou endereço) separados pela barra vertical “|”).
- chave (seu token de acesso autorizado a acessar o recurso).
Resposta no formato JSON (é a mesma em ambos os casos):
- A unidade de valor das durações é a segunda.
- A unidade de valor das distâncias é metro.
- Destinado ao roteamento de carros para obter a duração, considerando o tráfego ao vivo.
- Os pares de coordenadas nos quais a rota deve ser calculada. São necessários no mínimo dois pares.
Exemplo de resposta do Distance Matrix
{
"destination_addresses": [
"Westminster Abbey, 20 Deans Yd, London SW1P 3PA, United Kingdom"
],
"origin_addresses": [
"Chapel, London SW6 1BA, UK"
],
"rows": [
{
"elements": [
{
"distance": {
"text": "7.8 km",
"value": 7847
},
"duration": {
"text": "24 mins",
"value": 1481
}
}
]
}
],
"status": "OK"
}
{
"destination_addresses": [
"Westminster Abbey, 20 Deans Yd, London SW1P 3PA, United Kingdom"
],
"origin_addresses": [
"Chapel, London SW6 1BA, UK"
],
"rows": [
{
"elements": [
{
"distance": {
"text": "7.8 km",
"value": 7847
},
"duration": {
"text": "24 mins",
"value": 1481
},
"origin": "51.4822656,-0.1933769",
"destination": "Westminster Abbey, Westminster, London SW1P 3PA, UK",
"status": "OK"
}
]
}
],
"status": "OK"
}
