Pronto!

Para começar a desenvolver, acesse nossa documentação do desenvolvedor.

Ativar a Google Maps Directions API

Para começar, orientaremos você pelo Google Developers Console para realizar algumas atividades:

  1. Criar ou selecionar um projeto
  2. Ativar a Google Maps Directions API
  3. Criar chaves apropriadas
Continuar

Primeiros passos

A Google Maps Directions API é um serviço que calcula rotas entre locais. Você pode procurar rotas para diversos modos de transporte, incluindo transporte público, condução, caminhada ou bicicleta.

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 Directions API por meio de uma interface HTTP com solicitações criadas como uma string de URL, usando strings de texto ou coordenadas de latitude/longitude para identificar locais, juntamente com a chave de API.

O exemplo a seguir solicita rotas de condução da Disneyland até os Universal Studios Hollywood no formato JSON:

https://maps.googleapis.com/maps/api/directions/json?origin=Disneyland&destination=Universal+Studios+Hollywood4&key=YOUR_API_KEY

Experimente! Essa solicitação pode ser testada inserindo o URL no navegador da Web (não deixe de substituir 'YOUR_API_KEY' pela chave de API real). A resposta retorna as rotas de condução.

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:

{
   "geocoded_waypoints" : [
      {
         "geocoder_status" : "OK",
         "place_id" : "ChIJRVY_etDX3IARGYLVpoq7f68",
         "types" : [
            "bus_station",
            "transit_station",
            "point_of_interest",
            "establishment"
         ]
      },
      {
         "geocoder_status" : "OK",
         "partial_match" : true,
         "place_id" : "ChIJp2Mn4E2-woARQS2FILlxUzk",
         "types" : [ "route" ]
      }
   ],
   "routes" : [
      {
         "bounds" : {
            "northeast" : {
               "lat" : 34.1330949,
               "lng" : -117.9143879
            },
            "southwest" : {
               "lat" : 33.8068768,
               "lng" : -118.3527671
            }
         },
         "copyrights" : "Map data ©2016 Google",
         "legs" : [
            {
               "distance" : {
                  "text" : "35.9 mi",
                  "value" : 57824
               },
               "duration" : {
                  "text" : "51 mins",
                  "value" : 3062
               },
               "end_address" : "Universal Studios Blvd, Los Angeles, CA 90068, USA",
               "end_location" : {
                  "lat" : 34.1330949,
                  "lng" : -118.3524442
               },
               "start_address" : "Disneyland (Harbor Blvd.), S Harbor Blvd, Anaheim, CA 92802, USA",
               "start_location" : {
                  "lat" : 33.8098177,
                  "lng" : -117.9154353
               },

  ... Additional results truncated in this example[] ...


         "overview_polyline" : {
            "points" : "knjmEnjunUbKCfEA?_@]@kMBeE@qIIoF@wH@eFFk@WOUI_@?u@j@k@`@EXLTZHh@Y`AgApAaCrCUd@cDpDuAtAoApA{YlZiBdBaIhGkFrDeCtBuFxFmIdJmOjPaChDeBlDiAdD}ApGcDxU}@hEmAxD}[tt@yNb\\yBdEqFnJqB~DeFxMgK~VsMr[uKzVoCxEsEtG}BzCkHhKWh@]t@{AxEcClLkCjLi@`CwBfHaEzJuBdEyEhIaBnCiF|K_Oz\\
            {MdZwAbDaKbUiB|CgCnDkDbEiE|FqBlDsLdXqQra@kX|m@aF|KcHtLm@pAaE~JcTxh@w\\`v@gQv`@}F`MqK`PeGzIyGfJiG~GeLhLgIpIcE~FsDrHcFfLqDzH{CxEwAbBgC|B}F|DiQzKsbBdeA{k@~\\oc@bWoKjGaEzCoEzEwDxFsUh^wJfOySx[uBnCgCbCoFlDmDvAiCr@eRzDuNxC_EvAiFpCaC|AqGpEwHzFoQnQoTrTqBlCyDnGmCfEmDpDyGzGsIzHuZzYwBpBsC`CqBlAsBbAqCxAoBrAqDdDcNfMgHbHiPtReBtCkD|GqAhBwBzBsG~FoAhAaCbDeBvD_BlEyM``@uBvKiA~DmAlCkA|B}@lBcChHoJnXcB`GoAnIS~CIjFDd]A|QMlD{@jH[vAk@`CoGxRgPzf@aBbHoB~HeMx^eDtJ}BnG{DhJU`@mBzCoCjDaAx@mAnAgCnBmAp@uAj@{Cr@wBPkB@kBSsEW{GV}BEeCWyAWwHs@qH?
            cIHkDXuDn@mCt@mE`BsH|CyAp@}AdAaAtAy@lBg@pCa@jE]fEcBhRq@pJKlCk@hLFrB@lD_@xCeA`DoBxDaHvM_FzImDzFeCpDeC|CkExDiJrHcBtAkDpDwObVuCpFeCdHoIl\\uBjIuClJsEvMyDbMqAhEoDlJ{C|J}FlZuBfLyDlXwB~QkArG_AnDiAxC{G|OgEdLaE`LkBbEwG~KgHnLoEjGgDxCaC`BuJdFkFtCgCnBuClD_HdMqEzHcBpB_C|BuEzCmPlIuE|B_EtDeBhCgAdCw@rCi@|DSfECrCAdCS~Di@jDYhA_AlC{AxCcL`U{GvM_DjFkBzBsB`BqDhBaEfAsTvEmEr@iCr@qDrAiFnCcEzCaE~D_@JmFdGQDwBvCeErEoD|BcFjC}DbEuD~D`@Zr@h@?d@Wr@}@vAgCbEaHfMqA`Cy@dAg@bAO`@gCi@w@W"
         },
         "summary" : "I-5 N and US-101 N",
         "warnings" : [],
         "waypoint_order" : []
      }
   ],
   "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 Directions 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 Directions 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 seguir 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 Directions API.

Políticas

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

Saiba mais

Você pode fazer mais coisas com a Directions API, como solicitar rotas usando modos de transporte diferentes, usar pontos de referência para calcular rotas por meio de locais adicionais e estimar o tempo do percurso. Consulte o guia do desenvolvedor da Directions API para obter mais exemplos e outros detalhes.

Enviar comentários sobre…

Google Maps Directions API
Google Maps Directions API
Precisa de ajuda? Acesse nossa página de suporte.