Este produto ou recurso está no status Legado. Para mais informações sobre o estágio Legado e como migrar de serviços legados para serviços mais recentes, consulte
Produtos e recursos legados.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
Começar a usar a API Distance Matrix (legada)
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Exemplo de solicitação e resposta
Este exemplo solicita os dados da matriz de distância entre Washington, DC e Nova York, NY, no formato JSON:
URL
https://maps.googleapis.com/maps/api/distancematrix/json
?destinations=New%20York%20City%2C%20NY
&origins=Washington%2C%20DC
&units=imperial
&key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Washington%2C%20DC&destinations=New%20York%20City%2C%20NY&units=imperial&key=YOUR_API_KEY'
Faça um teste Teste essa solicitação inserindo o URL no navegador da Web. Não se
esqueça de substituir YOUR_API_KEY por sua chave de API
real. A resposta mostra a distância e a duração entre as origens e os destinos especificados.
Aprenda a criar URLs de solicitação,
incluindo todos os parâmetros disponíveis.
Este exemplo de código está nos formatos JSON e XML:
JSON
{
"destination_addresses": ["New York, NY, USA"],
"origin_addresses": ["Washington, DC, USA"],
"rows":
[
{
"elements":
[
{
"distance": { "text": "228 mi", "value": 367654 },
"duration": { "text": "3 hours 55 mins", "value": 14078 },
"status": "OK",
},
],
},
],
"status": "OK",
}
XML
OK
Washington, DC, USA
New York, NY, USA
OK
14078
3 hours 55 mins
367654
228 mi
Consulte o guia do desenvolvedor para entender a resposta.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2026-04-29 UTC.
[null,null,["Última atualização 2026-04-29 UTC."],[],["The content demonstrates requesting distance data between Washington, DC, and New York City using the Google Maps Distance Matrix API. The request URL and cURL command are provided, requiring the user to replace `YOUR_API_KEY` with their own. The API returns distance (228 mi) and duration (3 hours 55 mins) data in both JSON and XML formats. Users can test the URL and further understand responses, and can learn to build custom URL requests through provided documentation.\n"]]