Este produto está no status legado. A partir de outubro de 2026, não será mais possível ativar a API Directions (legada) para novos projetos do Google Cloud. Os projetos atuais continuam sendo totalmente compatíveis. Para novos recursos e melhor desempenho, migre para a API Routes.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Respostas de rotas

Desenvolvedores do Espaço Econômico Europeu (EEE)

Este produto está no status legado. A partir de outubro de 2026, a API Directions (legada) não poderá mais ser ativada para novos projetos na nuvem do Google Cloud. Os projetos atuais continuam totalmente compatíveis. Para novos recursos e melhor desempenho, migre para a API Routes.

Exemplos de respostas:

As respostas de rotas são retornadas no formato indicado pela flag output no caminho da solicitação de URL.

Veja abaixo um exemplo de solicitação HTTP que calcula o trajeto de Chicago, IL, para Los Angeles, CA, passando por dois pontos intermediários em Joplin, MO, e Oklahoma City, OK.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Los%20Angeles%2C%20CA
  &origin=Chicago%2C%20IL
  &waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Chicago%2C%20IL&destination=Los%20Angeles%2C%20CA&waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK&key=YOUR_API_KEY'

O exemplo acima solicita uma resposta em JSON. Também é possível solicitar a saída XML. Selecione as guias abaixo para ver as respostas de exemplo em JSON e XML.

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ7cv00DwsDogRAMDACa2m4K8",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgdL4flSKrYcRnTpP0XQSojM",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJE9on3F3HwoAR9AhGJW_fL-I",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 41.8781139, "lng": -87.6297872 },
            "southwest": { "lat": 34.0523525, "lng": -118.2435717 },
          },
        "copyrights": "Map data ©2022 Google, INEGI",
        "legs":
          [
            {
              "distance": { "text": "579 mi", "value": 932311 },
              "duration": { "text": "8 hours 48 mins", "value": 31653 },
              "end_address": "Joplin, MO, USA",
              "end_location": { "lat": 37.0842449, "lng": -94.513284 },
              "start_address": "Chicago, IL, USA",
              "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
              "steps":
                [
                  {
                    "distance": { "text": "443 ft", "value": 135 },
                    "duration": { "text": "1 min", "value": 24 },
                    "end_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "html_instructions": "Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b>",
                    "polyline": { "points": "eir~FdezuOdCEjBC" },
                    "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
                    "travel_mode": "DRIVING",
                  },
                  {
                    "distance": { "text": "269 ft", "value": 82 },
                    "duration": { "text": "1 min", "value": 20 },
                    "end_location": { "lat": 41.8768866, "lng": -87.63073 },
                    "html_instructions": "Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b>",
                    "maneuver": "turn-right",
                    "polyline": { "points": "sar~FzdzuO@fC?|@" },
                    "start_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
            // Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity
          ],
        "overview_polyline":
          {
            "points": "eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)",
          },
        "summary": "I-55 S and I-44",
        "warnings": [],
        "waypoint_order": [0, 1],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>I-55 S and I-44</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8781139</lat>
     <lng>-87.6297872</lng>
    </start_location>
    <end_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </end_location>
    <polyline>
     <points>eir~FdezuOdCEjBC</points>
    </polyline>
    <duration>
     <value>24</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Head &lt;b&gt;south&lt;/b&gt; on &lt;b&gt;S Federal St&lt;/b&gt; toward &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>135</value>
     <text>443 ft</text>
    </distance>
   </step>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </start_location>
    <end_location>
     <lat>41.8768866</lat>
     <lng>-87.6307300</lng>
    </end_location>
    <polyline>
     <points>sar~FzdzuO@fC?|@</points>
    </polyline>
    <duration>
     <value>20</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Turn &lt;b&gt;right&lt;/b&gt; at the 1st cross street onto &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>82</value>
     <text>269 ft</text>
    </distance>
    <maneuver>turn-right</maneuver>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>31653</value>
    <text>8 hours 48 mins</text>
   </duration>
   <distance>
    <value>932311</value>
    <text>579 mi</text>
   </distance>
   <start_location>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </start_location>
   <end_location>
    <lat>37.0842449</lat>
    <lng>-94.5132840</lng>
   </end_location>
   <start_address>Chicago, IL, USA</start_address>
   <end_address>Joplin, MO, USA</end_address>
  </leg>
  <!-- Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity -->
  <copyrights>Map data ©2022 Google, INEGI</copyrights>
  <overview_polyline>
   <points>eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)</points>
  </overview_polyline>
  <waypoint_index>0</waypoint_index>
  <waypoint_index>1</waypoint_index>
  <bounds>
   <southwest>
    <lat>34.0523525</lat>
    <lng>-118.2435717</lng>
   </southwest>
   <northeast>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ7cv00DwsDogRAMDACa2m4K8</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ69Pk6jdlyIcRDqM1KDY3Fpg</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgdL4flSKrYcRnTpP0XQSojM</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJE9on3F3HwoAR9AhGJW_fL-I</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

O restante deste documento usará a sintaxe JSON. Na maioria dos casos, o formato de saída não importa para ilustrar conceitos ou nomes de campos na documentação. No entanto, observe as seguintes diferenças sutis:

Os resultados XML são unidos em um elemento raiz <DirectionsResponse>.
O JSON indica entradas com vários elementos por matrizes plurais (como steps e legs), enquanto o XML as indica usando vários elementos singulares (como <step> e <leg>).
O JSON indica a ordem dos pontos de passagem pelo campo waypoint_order, enquanto o XML usa elementos <waypoint_index> individuais.
Os elementos em branco são indicados por matrizes vazias em JSON, mas pela ausência de qualquer elemento desse tipo em XML. Uma resposta que não gera resultados vai retornar uma matriz routes vazia em JSON, mas nenhum elemento <route> em XML, por exemplo.

DirectionsResponse

Campo	Obrigatório	Tipo	Descrição
`routes`	required	Array<DirectionsRoute>	Contém uma matriz de rotas da origem ao destino. As rotas consistem em trechos e etapas aninhados. Consulte DirectionsRoute para mais informações.
`status`	required	DirectionsStatus	Contém o status da solicitação e pode conter informações de depuração para ajudar a rastrear o motivo da falha da solicitação. Consulte DirectionsStatus para mais informações.
`available_travel_modes`	opcional	Array<TravelMode>	Contém uma matriz de meios de transporte disponíveis. Esse campo é retornado quando uma solicitação especifica um meio de transporte e não recebe resultados. A matriz contém os meios de transporte disponíveis nos países do conjunto de waypoints fornecido. Esse campo não será retornado se um ou mais waypoints forem "via waypoints". Consulte TravelMode para mais informações.
`error_message`	opcional	string	Quando o serviço retorna um código de status diferente de `OK`, pode haver um campo `error_message` adicional no objeto de resposta. Esse campo contém informações mais detalhadas sobre os motivos do código de status fornecido. Esse campo nem sempre é retornado, e o conteúdo dele está sujeito a alterações.
`geocoded_waypoints`	opcional	Array<DirectionsGeocodedWaypoint>	Contém uma matriz com detalhes sobre a geocodificação da origem, do destino e dos waypoints. Os elementos na matriz geocoded_waypoints correspondem, pela posição baseada em zero, à origem, aos waypoints na ordem em que são especificados e ao destino. Esses detalhes não estarão presentes para waypoints especificados como valores textuais de latitude/longitude se o serviço não retornar resultados. Isso ocorre porque esses waypoints só são geocodificados de forma reversa para receber o endereço representativo depois que uma rota é encontrada. Um objeto JSON vazio vai ocupar os lugares correspondentes na matriz geocoded_waypoints. Consulte DirectionsGeocodedWaypoint para mais informações.

DirectionsRoute

As rotas consistem em legs e steps aninhados.

Campo	Obrigatório	Tipo	Descrição
`bounds`	required	Limites	Contém a caixa delimitadora da janela de visualização do `overview_polyline`. Consulte Limites para mais informações.
`copyrights`	required	string	Contém as notificações de direitos autorais a serem mostradas para este trajeto. Você precisa processar e mostrar essas informações por conta própria. O conteúdo precisa ser lido no estado em que se encontra. Não analise esse conteúdo de forma programática.
`legs`	required	Matriz<DirectionsLeg>	Uma matriz que contém informações sobre um trecho do trajeto, entre dois locais dentro do trajeto especificado. É definido um trecho separado para cada waypoint ou destino especificado. Um trajeto sem waypoints contém exatamente um trecho na matriz legs. Cada trecho consiste em uma série de etapas. Consulte DirectionsLeg para mais informações.
`overview_polyline`	required	DirectionsPolyline	Contém um objeto que contém uma representação de polilinha codificada do trajeto. Essa polilinha é um caminho aproximado (suavizado) da rota resultante. Consulte DirectionsPolyline para mais informações.
`summary`	required	string	Contém uma breve descrição textual do trajeto, adequada para nomear e diferenciar o trajeto das alternativas.
`warnings`	required	Array<string>	Contém uma matriz de avisos que serão mostrados quando essas rotas forem mostradas. Você precisa processar e mostrar esses avisos manualmente.
`waypoint_order`	required	Matriz<inteiro>	Uma matriz que indica a ordem dos waypoints no trajeto calculado. Esses waypoints poderão ser reordenados se a solicitação tiver recebido optimize:true no parâmetro de waypoints.
`fare`	opcional	Tarifa	se presente, contém o total das passagens para essa rota. Essa propriedade é retornada somente para solicitações de transporte público e apenas para trajetos em que as informações de tarifas estão disponíveis para todos os trechos do percurso. Consulte Tarifa para mais informações.

Limites

Um retângulo em coordenadas geográficas de pontos nos cantos sudoeste e nordeste.

Campo	Obrigatório	Tipo	Descrição
`northeast`	required	LatLngLiteral	Consulte LatLngLiteral para mais informações.
`southwest`	required	LatLngLiteral	Consulte LatLngLiteral para mais informações.

LatLngLiteral

Um objeto que descreve um local específico com latitude e longitude em graus decimais.

Campo	Obrigatório	Tipo	Descrição
`lat`	required	número	Latitude em graus decimais
`lng`	required	número	Longitude em graus decimais

DirectionsLeg

Campo	Obrigatório	Tipo	Descrição
`end_address`	required	string	Contém o endereço legível por humanos (geralmente um endereço) da geocodificação inversa do `end_location` deste trecho. O conteúdo precisa ser lido no estado em que se encontra. Não analise o endereço formatado de maneira programática.
`end_location`	required	LatLngLiteral	As coordenadas de latitude/longitude do destino especificado para este trecho. Como a API Directions calcula rotas entre locais usando a opção de transporte mais próxima (geralmente uma estrada) do ponto inicial e final, o campo `end_location` pode ser diferente do destino fornecido para este trecho se, por exemplo, não houver uma estrada próxima do destino. Consulte LatLngLiteral para mais informações.
`start_address`	required	string	Contém o endereço legível por humanos (geralmente um endereço de rua) resultante da geocodificação inversa do `start_location` deste trecho. O conteúdo precisa ser lido no estado em que se encontra. Não analise o endereço formatado de maneira programática.
`start_location`	required	LatLngLiteral	As coordenadas de latitude/longitude da origem desse trecho. Como a API Directions calcula rotas entre locais usando a opção de transporte mais próxima (geralmente uma estrada) do ponto inicial e final, o campo `start_location` pode ser diferente da origem fornecida para este trecho se, por exemplo, não houver uma estrada próxima da origem. Consulte LatLngLiteral para mais informações.
`steps`	required	Array<DirectionsStep>	Uma matriz de etapas com informações sobre cada etapa específica do trecho do caminho. Consulte DirectionsStep para mais informações.
`traffic_speed_entry`	opcional	Array<DirectionsTrafficSpeedEntry>	Descontinuado:essa matriz está sempre vazia. Informações sobre a velocidade do trânsito ao longo do trecho. Consulte DirectionsTrafficSpeedEntry para mais informações.
`via_waypoint`	required	Matriz<DirectionsViaWaypoint>	Os locais dos waypoints intermediários ao longo deste trecho. Consulte DirectionsViaWaypoint para mais informações.
`arrival_time`	opcional	TimeZoneTextValueObject	Contém o horário previsto de chegada para esse trecho. Essa propriedade é retornada apenas para rotas de transporte público. Consulte TimeZoneTextValueObject para mais informações.
`departure_time`	opcional	TimeZoneTextValueObject	Contém o horário estimado de partida para este trecho, especificado como um objeto Time. O `departure_time` só está disponível para rotas de transporte público. Consulte TimeZoneTextValueObject para mais informações.
`distance`	opcional	TextValueObject	A distância total coberta por este trecho. Consulte TextValueObject para mais informações.
`duration`	opcional	TextValueObject	A duração total deste trecho. Consulte TextValueObject para mais informações.
`duration_in_traffic`	opcional	TextValueObject	Indica a duração total desse trecho. Esse valor é uma estimativa do tempo no trânsito com base nas condições de trânsito atuais e históricas. Consulte o parâmetro de solicitação `traffic_model` para ver as opções que podem ser usadas para solicitar que o valor retornado seja otimista, pessimista ou uma estimativa aproximada. A duração no trânsito só será retornada se todas as condições a seguir forem verdadeiras: A solicitação não inclui waypoints com parada. Se a solicitação incluir waypoints, eles precisam ter o prefixo `via:` para evitar paradas. A solicitação é específica para rotas de carro. O parâmetro mode é definido como `driving`. A solicitação inclui um parâmetro `departure_time`. Há condições de trânsito disponíveis para o trajeto solicitado. Consulte TextValueObject para mais informações.

DirectionsStep

Cada elemento na matriz de steps define uma única etapa da rota calculada. Uma etapa é a menor unidade do trajeto de uma rota e contém uma única etapa que descreve uma instrução única e específica da jornada. Por exemplo, "Vire à esquerda na Avenida Brasil". A etapa não só descreve a instrução, como também contém informações de distância e duração indicando como a etapa está relacionada à etapa seguinte. Por exemplo, uma etapa indicada como "Entre na I-80 West" pode conter uma distância de "37 milhas" e uma duração de "40 minutos", indicando que a próxima etapa está a 37 milhas/40 minutos da etapa atual.

Ao usar a API Directions para pesquisar rotas de transporte público, a matriz de etapas inclui mais detalhes de transporte público na forma de uma matriz transit_details. Se as rotas incluem vários modos de transporte, são fornecidas rotas detalhadas para etapas a pé ou de carro em uma matriz de etapas internas. Por exemplo, uma etapa a pé inclui rotas dos locais inicial e final: "Caminhe até a Innes Ave e Fitch Street". Essa etapa incluirá rotas a pé detalhadas para esse trajeto na matriz de etapas internas, como: "Siga para o Noroeste", "Vire à esquerda na Arelious Walker" e "Vire à esquerda na Innes Avenue".

Campo	Obrigatório	Tipo	Descrição
`duration`	required	TextValueObject	Contém o tempo típico necessário para realizar a etapa, até a etapa seguinte. Esse campo pode ser indefinido se a duração é desconhecida. Consulte TextValueObject para mais informações.
`end_location`	required	LatLngLiteral	Contém o local do último ponto desta etapa. Consulte LatLngLiteral para mais informações.
`html_instructions`	required	string	Contém instruções formatadas para esta etapa, apresentadas como uma string de texto HTML. Esse conteúdo precisa ser lido no estado em que se encontra. Não analise de maneira programática esse conteúdo somente para exibição.
`polyline`	required	DirectionsPolyline	Contém um único objeto de pontos que contém uma representação da polilinha codificada da etapa. Essa polilinha é um caminho aproximado (suavizado) da etapa. Consulte DirectionsPolyline para mais informações.
`start_location`	required	LatLngLiteral	Contém o local do ponto de partida desta etapa. Consulte LatLngLiteral para mais informações.
`travel_mode`	required	TravelMode	Contém o tipo de meio de transporte usado. Consulte TravelMode para mais informações.
`distance`	opcional	TextValueObject	Contém a distância coberta por esta etapa até a próxima. Esse campo pode ser indefinido se a distância é desconhecida. Consulte TextValueObject para mais informações.
`maneuver`	opcional	string	Contém a ação a ser realizada na etapa atual (virar à esquerda, entrar, seguir em frente etc.). Os valores estão sujeitos a mudanças, e novos valores podem ser adicionados sem aviso prévio. The allowed values include: `turn-slight-left`, `turn-sharp-left`, `turn-left`, `turn-slight-right`, `turn-sharp-right`, `keep-right`, `keep-left`, `uturn-left`, `uturn-right`, `turn-right`, `straight`, `ramp-left`, `ramp-right`, `merge`, `fork-left`, `fork-right`, `ferry`, `ferry-train`, `roundabout-left`, and `roundabout-right`
`steps`	opcional		Contém rotas detalhadas para etapas de caminhada ou condução nas rotas de transporte público. As subetapas só estão disponíveis quando travel_mode está definido como "transit". A matriz de etapas internas é do mesmo tipo que as etapas.
`transit_details`	opcional	DirectionsTransitDetails	Detalhes referentes a esta etapa se o meio de transporte for `transit`. Consulte DirectionsTransitDetails para mais informações.

TextValueObject

Um objeto que contém um valor numérico e a representação de texto formatada dele.

Campo	Obrigatório	Tipo	Descrição
`text`	required	string	Valor da string.
`value`	required	número	Valor numérico.

DirectionsPolyline

A codificação de polilinhas é um algoritmo de compactação com perda que permite armazenar uma série de coordenadas como uma única string. Coordenadas de pontos são codificadas usando valores com sinal. Se você tiver apenas alguns pontos estáticos, use o utilitário interativo de codificação de polilinhas.

O processo de codificação converte um valor binário em uma série de códigos de caracteres ASCII usando o esquema de codificação base64: para garantir a exibição adequada desses caracteres, os valores codificados são somados com 63 (o caractere ASCII "?") antes de serem convertidos em ASCII. O algoritmo também verifica se há códigos de caracteres adicionais para um determinado ponto, verificando o bit menos significativo de cada grupo de bytes. Se esse bit for definido como 1, o ponto ainda não estará totalmente formado e dados adicionais deverão ser adicionados.

Além disso, para economizar espaço, os pontos incluem apenas o deslocamento do ponto anterior (exceto, é claro, para o primeiro ponto). Todos os pontos são codificados em Base64 como números inteiros com sinal, já que as latitudes e longitudes são valores com sinal. O formato de codificação em uma polilinha precisa representar duas coordenadas de latitude e longitude com uma precisão razoável. Considerando uma longitude máxima de +/- 180 graus com uma precisão de 5 casas decimais (180,00000 a -180,00000), é necessário um valor inteiro binário assinado de 32 bits.

Campo	Obrigatório	Tipo	Descrição
`points`	required	string	Uma única representação de string da polilinha.

TravelMode

DRIVING (padrão) indica o cálculo usando a rede viária.
BICYCLING solicita o cálculo para bicicleta usando ciclovias e ruas preferenciais (quando disponível).
TRANSIT solicita o cálculo usando trajetos de transporte público (quando disponível).
WALKING solicita o cálculo para rotas a pé usando faixas de pedestres e calçadas (quando disponível).

DirectionsTransitDetails

Informações adicionais que não são relevantes para outros modos de transporte.

Campo	Obrigatório	Tipo	Descrição
`arrival_stop`	opcional	DirectionsTransitStop	A parada de chegada do transporte público. Consulte DirectionsTransitStop para mais informações.
`arrival_time`	opcional	TimeZoneTextValueObject	Consulte TimeZoneTextValueObject para mais informações.
`departure_stop`	opcional	DirectionsTransitStop	A parada de transporte público de partida. Consulte DirectionsTransitStop para mais informações.
`departure_time`	opcional	TimeZoneTextValueObject	Consulte TimeZoneTextValueObject para mais informações.
`headsign`	opcional	string	Especifica a direção de deslocamento nessa linha, conforme marcada no veículo ou no ponto de partida. Essa parada é, com frequência, a estação terminal.
`headway`	opcional	número inteiro	Especifica o número esperado de segundos entre as partidas no mesmo ponto, nesse horário. Por exemplo, se `headway` tiver o valor de 600, aguarde 10 minutos caso perca o ônibus.
`line`	opcional	DirectionsTransitLine	Contém informações sobre a linha de transporte público usada nesta etapa. Consulte DirectionsTransitLine para mais informações.
`num_stops`	opcional	número inteiro	O número de paradas entre a partida e a chegada. Esse número inclui a parada de chegada, mas não a de partida. Por exemplo, se as rotas envolvem sair da parada A, passar pelas paradas B e C e chegar à parada D, `num_stops` vai retornar 3.
`trip_short_name`	opcional	string	O texto que aparece em programações e placas para identificar uma viagem de transporte público para os passageiros. O texto precisa identificar exclusivamente uma viagem em um dia de serviço. Por exemplo, "538" é o `trip_short_name` do trem da Amtrak que sai de San Jose, CA, às 15h10 nos dias úteis para Sacramento, CA.

DirectionsTransitStop

Campo	Obrigatório	Tipo	Descrição
`location`	required	LatLngLiteral	O local da parada. Consulte LatLngLiteral para mais informações.
`name`	required	string	O nome da parada de transporte público.

TimeZoneTextValueObject

Um objeto que contém o horário de época Unix, um fuso horário e a representação de texto formatada.

Campo	Obrigatório	Tipo	Descrição
`text`	required	string	O horário especificado como uma string no fuso horário.
`time_zone`	required	string	Contém o fuso horário. O valor é o nome do fuso horário conforme definido no banco de dados de fusos horários da IANA, por exemplo, "America/New_York".
`value`	required	número	O horário especificado como horário da época Unix ou segundos desde a meia-noite de 1º de janeiro de 1970 UTC.

DirectionsTransitLine

Campo	Obrigatório	Tipo	Descrição
`agencies`	required	Array<DirectionsTransitAgency>	A empresa (ou empresas) de transporte público que opera essa linha. Consulte DirectionsTransitAgency para mais informações.
`name`	required	string	O nome completo da linha de transporte público, por exemplo, "8 Avenue Local".
`color`	opcional	string	A cor normalmente usada na sinalização dessa linha.
`icon`	opcional	string	Contém o URL do ícone associado a essa linha.
`short_name`	opcional	string	O nome curto da linha de transporte público. Normalmente, será o número da linha, como "M7" ou "355".
`text_color`	opcional	string	A cor normalmente usada na sinalização dessa linha.
`url`	opcional	string	Contém o URL dessa linha de transporte público, conforme fornecido pela empresa de transporte público.
`vehicle`	opcional	DirectionsTransitVehicle	O tipo de veículo que opera nessa linha de transporte público. Consulte DirectionsTransitVehicle para mais informações.

DirectionsTransitAgency

Campo	Obrigatório	Tipo	Descrição
`name`	opcional	string	O nome da empresa de transporte público.
`phone`	opcional	string	O número de telefone da empresa de transporte público.
`url`	opcional	string	O URL da empresa de transporte público.

DirectionsTransitVehicle

Campo	Obrigatório	Tipo	Descrição
`name`	required	string	O nome do veículo, em letras maiúsculas.
`type`	required	string	O tipo de veículo usado. `BUS` - Ônibus. `CABLE_CAR`: um veículo que opera por meio de um cabo, normalmente terrestre. Bondes aéreos podem ser do tipo GONDOLA_LIFT. `COMMUTER_TRAIN`: trem metropolitano. `FERRY` - Balsa. `FUNICULAR`: um veículo puxado por cabo em declives acentuados. Geralmente, um funicular consiste em dois carros, cada um atuando como contrapeso do outro. `GONDOLA_LIFT`: um bonde aéreo. `HEAVY_RAIL`: trem de alta capacidade. `HIGH_SPEED_TRAIN`: trem de alta velocidade. `INTERCITY_BUS`: ônibus intermunicipal. `LONG_DISTANCE_TRAIN`: trem de longa distância. `METRO_RAIL`: veículo leve sobre trilhos (VLT). `MONORAIL`: monotrilho. `OTHER`: todos os demais veículos vão retornar esse tipo. `RAIL` - Via férrea. `SHARE_TAXI`: dividir um táxi é uma forma de ônibus, com a possibilidade de deixar e pegar passageiros em qualquer ponto do trajeto. `SUBWAY`: veículo leve subterrâneo. `TRAM`: veículo leve acima do chão. `TROLLEYBUS`: ônibus elétrico. The allowed values include: `BUS`, `CABLE_CAR`, `COMMUTER_TRAIN`, `FERRY`, `FUNICULAR`, `GONDOLA_LIFT`, `HEAVY_RAIL`, `HIGH_SPEED_TRAIN`, `INTERCITY_BUS`, `LONG_DISTANCE_TRAIN`, `METRO_RAIL`, `MONORAIL`, `OTHER`, `RAIL`, `SHARE_TAXI`, `SUBWAY`, `TRAM`, and `TROLLEYBUS`
`icon`	opcional	string	Contém o URL de um ícone associado a esse tipo de veículo.
`local_icon`	opcional	string	Contém o URL do ícone associado a esse tipo de veículo, com base na sinalização de transporte local.

DirectionsTrafficSpeedEntry

Campo	Obrigatório	Tipo	Descrição
`offset_meters`	required	número	O deslocamento ao longo do trajeto (em metros) até o qual essa categoria de velocidade é válida.
`speed_category`	required	string	As condições atuais de trânsito/velocidade nessa parte de um trajeto.

DirectionsViaWaypoint

Campo	Obrigatório	Tipo	Descrição
`location`	opcional	LatLngLiteral	O local do waypoint. Consulte LatLngLiteral para mais informações.
`step_index`	opcional	número inteiro	O índice da etapa que contém o waypoint.
`step_interpolation`	opcional	número	A posição do waypoint ao longo da polilinha da etapa, expressa como uma proporção de 0 a 1.

Tarifa

A tarifa total do trajeto.

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}

Campo	Obrigatório	Tipo	Descrição
`currency`	required	string	Um código de moeda ISO 4217 que indica a moeda em que o valor é expresso.
`text`	required	string	o total de passagens formatado no idioma solicitado.
`value`	required	número	O valor total das tarifas na moeda especificada.

DirectionsStatus

O campo de status no objeto de resposta do Directions contém o status da solicitação e pode conter informações de depuração para ajudar a rastrear o motivo da falha do serviço Directions. O campo de status pode conter os seguintes valores:

OK indica que a resposta contém um resultado válido.
NOT_FOUND indica que não foi possível geocodificar pelo menos um dos locais especificados na origem, no destino ou nos waypoints da solicitação.
ZERO_RESULTS: indica que não foi possível encontrar nenhum trajeto entre a origem e o destino.
MAX_WAYPOINTS_EXCEEDED indica que muitos waypoints foram fornecidos na solicitação. Para aplicativos que usam a API Directions como um serviço da Web ou o serviço Directions na API Maps JavaScript, o número máximo permitido de waypoints é 25, além da origem e do destino.
MAX_ROUTE_LENGTH_EXCEEDED indica que o trajeto solicitado é muito longo e não pode ser processado. Esse erro ocorre quando rotas mais complexas são retornadas. Tente reduzir o número de waypoints, curvas ou instruções.
INVALID_REQUEST indica que a solicitação fornecida era inválida. As causas comuns desse status incluem um parâmetro ou valor de parâmetro inválido.
OVER_DAILY_LIMIT indica qualquer uma das seguintes opções:
- A chave de API está ausente ou é inválida.
- O faturamento não foi ativado na sua conta.
- Um limite de uso definido pelo próprio usuário foi excedido.
- A forma de pagamento fornecida não é mais válida (por exemplo, o cartão de crédito expirou).
Consulte as Perguntas frequentes do Maps para saber como corrigir isso.
OVER_QUERY_LIMIT indica que o serviço recebeu solicitações em excesso do seu aplicativo dentro do período permitido.
REQUEST_DENIED indica que o serviço Directions foi recusado para seu aplicativo.
UNKNOWN_ERROR indica que não foi possível processar uma solicitação de rotas devido a um erro de servidor. Se você tentar novamente, a solicitação poderá dar certo.

DirectionsGeocodedWaypoint

Campo	Obrigatório	Tipo	Descrição
`geocoder_status`	opcional	string	Indica o código de status resultante da operação de geocodificação. Esse campo pode conter os seguintes valores: The allowed values include: `OK`, and `ZERO_RESULTS`
`partial_match`	opcional		Indica que o geocodificador não retornou uma correspondência exata para a solicitação original, mas conseguiu corresponder parte do endereço solicitado. Convém verificar se a solicitação original inclui erros de ortografia e/ou um endereço incompleto. Correspondências parciais ocorrem com mais frequência para endereços que não existem na localidade onde você enviou a solicitação. Elas também podem ser retornadas quando uma solicitação corresponde a dois ou mais locais na mesma localidade. Por exemplo, "21 Henr St, Bristol, UK" vai retornar uma correspondência parcial para Henry Street e Henrietta Street. Se uma solicitação incluir um componente de endereço com um erro ortográfico, o serviço de geocodificação pode sugerir um endereço alternativo. Sugestões acionadas dessa maneira também vão ser marcadas como correspondências parciais.
`place_id`	opcional	string	Um identificador exclusivo que pode ser usado com outras APIs do Google. Consulte a visão geral do ID de lugar.
`types`	opcional	Array<string>	Indica o tipo de endereço do resultado da geocodificação usado para calcular as rotas. `administrative_area_level_1` indica uma entidade civil de primeira ordem abaixo do nível do país. Nos Estados Unidos, esses níveis administrativos são estados. Nem todos os países incluem esses níveis administrativos. Na maioria dos casos, nomes curtos para administrative_area_level_1 vão respeitar quase que totalmente as subdivisões da ISO 3166-2 e outras normas amplamente divulgadas. Porém, isso não é garantido, já que os resultados da nossa geocodificação se baseiam em vários sinais e dados de localização. `administrative_area_level_2` indica uma entidade civil de segunda ordem abaixo do nível de país. Nos Estados Unidos, esses níveis administrativos são condados. Nem todos os países incluem esses níveis administrativos. `administrative_area_level_3` indica uma entidade civil de terceira ordem abaixo do nível de país. Esse tipo indica uma divisão civil secundária. Nem todos os países incluem esses níveis administrativos. `administrative_area_level_4` indica uma entidade civil de quarta ordem abaixo do nível do país. Esse tipo indica uma divisão civil secundária. Nem todos os países incluem esses níveis administrativos. `administrative_area_level_5` indica uma entidade civil de quinta ordem abaixo do nível do país. Esse tipo indica uma divisão civil secundária. Nem todos os países incluem esses níveis administrativos. `airport` indica um aeroporto. `colloquial_area` indica um nome alternativo usado comumente para a entidade. `country` indica a entidade política nacional e costuma ser o tipo de ordem mais elevada retornado pelo geocodificador. `intersection` indica uma interseção principal, normalmente de duas estradas principais. `locality` indica uma entidade política de cidade ou município incorporada. `natural_feature` indica um recurso natural de destaque. `neighborhood` indica um bairro nomeado `park` indica um parque nomeado. `plus_code` indica uma referência de local codificada, derivada de latitude e longitude. Os Plus Codes podem ser usados em vez de endereços nos lugares em que não existem, ou seja, quando os imóveis não estão numerados ou as ruas não têm nome. Para mais detalhes, consulte https://plus.codes. `point_of_interest` indica um ponto de interesse nomeado. Normalmente, esses "PDIs" são entidades locais de destaque que não se encaixam facilmente em outra categoria, como "Empire State Building" ou "Torre Eiffel". `political` indica uma entidade política. Normalmente, esse tipo indica um polígono de administração civil. `postal_code` indica um código postal, conforme usado para endereçar correspondências no país. `premise` indica um local nomeado, normalmente um edifício ou condomínios com um nome comum `route` indica uma rota nomeada (como "US 101"). `street_address` indica um endereço preciso. `sublocality` indica uma entidade civil de primeira ordem abaixo da localidade. Para alguns locais, é possível receber um dos tipos adicionais: sublocality_level_1 até sublocality_level_5. Cada nível de sublocalidade é uma entidade civil. Números maiores indicam uma área geográfica menor. `subpremise` indica uma entidade de primeira ordem abaixo de uma localização com nome, geralmente um prédio dentro de um conjunto que prédios com um nome em comum `tourist_attraction` indica uma atração turística. `train_station` indica uma estação de trem. `transit_station` indica uma estação de transporte público. Uma lista vazia indica que não há tipos conhecidos para um componente de endereço específico, por exemplo, Lieu-dit na França.

Respostas de rotas Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Exemplos de respostas:

URL

curl

JSON

XML

DirectionsResponse

routes

status

available_travel_modes

error_message

geocoded_waypoints

DirectionsRoute

bounds

copyrights

legs

overview_polyline

summary

warnings

waypoint_order

fare

Limites

northeast

southwest

LatLngLiteral

lat

lng

DirectionsLeg

end_address

end_location

start_address

start_location

steps

traffic_speed_entry

via_waypoint

arrival_time

departure_time

distance

duration

duration_in_traffic

DirectionsStep

duration

end_location

html_instructions

polyline

start_location

travel_mode

distance

maneuver

steps

transit_details

TextValueObject

text

value

DirectionsPolyline

points

TravelMode

DirectionsTransitDetails

arrival_stop

arrival_time

departure_stop

departure_time

headsign

headway

line

num_stops

trip_short_name

DirectionsTransitStop

location

name

TimeZoneTextValueObject

text

time_zone

value

DirectionsTransitLine

agencies

name

color

icon

short_name

Respostas de rotas

`routes`

`status`

`available_travel_modes`

`error_message`

`geocoded_waypoints`

`bounds`

`copyrights`

`legs`

`overview_polyline`

`summary`

`warnings`

`waypoint_order`

`fare`

`northeast`

`southwest`

`lat`

`lng`

`end_address`

`end_location`

`start_address`

`start_location`

`steps`

`traffic_speed_entry`

`via_waypoint`

`arrival_time`

`departure_time`

`distance`

`duration`

`duration_in_traffic`

`duration`

`end_location`

`html_instructions`

`polyline`

`start_location`

`travel_mode`

`distance`

`maneuver`

`steps`

`transit_details`

`text`

`value`

`points`

`arrival_stop`

`arrival_time`

`departure_stop`

`departure_time`

`headsign`

`headway`

`line`

`num_stops`

`trip_short_name`

`location`

`name`

`text`

`time_zone`

`value`

`agencies`

`name`

`color`

`icon`

`short_name`

`text_color`

`url`

`vehicle`

`name`

`phone`

`url`

`name`

`type`

`icon`

`local_icon`

`offset_meters`

`speed_category`

`location`

`step_index`

`step_interpolation`

`currency`

`text`

`value`