Primeiros passos

A Google Maps Distance Matrix API é um serviço que fornece a distância e o tempo de percurso para uma matriz de origens e destinos, de acordo com a rota recomendada entre os pontos de partida e chegada.

Este serviço também está disponível como parte da Google Maps JavaScript API do lado do cliente ou para uso do lado do servidor com Java Client, Python Client, Go Client e Node.js Client for Google Maps Services.

Exemplo de solicitação e resposta

Você acessa a Google Maps Distance Matrix API por meio de uma interface HTTP com solicitações criadas como uma string de URL, usando origins e destinations com a chave de API.

O exemplo a seguir solicita dados da matriz de distâncias entre Washington, DC e New York City, NY no formato JSON:

https://maps.googleapis.com/maps/api/distancematrix/json?units=imperial&origins=Washington,DC&destinations=New+York+City,NY&key=YOUR_API_KEY

Experimente! Esse exemplo pode ser testado inserindo o URL no navegador da Web (não deixe de substituir YOUR_API_KEY pela chave de API real). A resposta inclui a distância e a duração entre as origens e destinos especificados.

Consulte o guia do desenvolvedor para obter mais informações sobre a criação de URLs de solicitação e os parâmetros disponíveis, bem como sobre como interpretar a resposta.

Veja a seguir um exemplo de resposta em JSON:

{
   "destination_addresses" : [ "New York, NY, USA" ],
   "origin_addresses" : [ "Washington, DC, USA" ],
   "rows" : [
      {
         "elements" : [
            {
               "distance" : {
                  "text" : "225 mi",
                  "value" : 361715
               },
               "duration" : {
                  "text" : "3 hours 49 mins",
                  "value" : 13725
               },
               "status" : "OK"
            }
         ]
      }
   ],
   "status" : "OK"
}

Começar a codificar com nossas bibliotecas cliente

As bibliotecas cliente facilitam o desenvolvimento com as Web Service APIs do Google Maps, oferecendo implementações simples e nativas de tarefas comuns, como autenticação, limitação de solicitações e novas tentativas automáticas. A Google Maps Distance Matrix API está disponível nos clientes Java Client, Python Client, Go Client e Node.js Client for Google Maps Services.

Autenticação, cotas e políticas

Ativar a API e obter uma chave de API

Para usar a Google Maps Distance Matrix API, você deve antes ativar a API no Google API Console e obter as credenciais de autenticação adequadas. Você precisa informar uma chave de API em cada solicitação (ou um ID do cliente se tiver um Plano premium).

Clique no botão a seguir para continuar em um processo onde você poderá:

1. Criar ou selecionar um projeto
2. Ativar a API
3. Obter uma chave de API

Obter uma chave

Saiba mais sobre a autenticação de credenciais.

Cotas

Consulte a página de limites de uso para obter detalhes sobre as cotas definidas para a Google Maps Distance Matrix API.

Políticas

O uso da Google Maps Distance Matrix API deve estar de acordo com as políticas de APIs.

Saiba mais

Você pode fazer mais coisas com a Distance Matrix API, como solicitar dados de distância para modos de transporte diferentes, solicitar dados de distância em unidades diferentes (por exemplo, quilômetros ou milhas) e estimar o tempo do percurso no tráfego. Consulte o guia do desenvolvedor da Distance Matrix API para obter mais exemplos e outros detalhes.