Pontos de navegação

O campo navigation_points na resposta de geocodificação contém uma lista de pontos úteis para navegar até o lugar. Especificamente, eles precisam ser usados como pontos de partida ou chegada ao calcular rotas em uma rede rodoviária de ou para o lugar. Cada ponto de navegação contém os seguintes valores:

  • location contém o valor de latitude e longitude do ponto de navegação. Esse local sempre fica muito próximo à rede rodoviária e representa um ponto de parada ou de partida ideal para navegar de um lugar para outro. O ponto é intencionalmente ligeiramente deslocado da linha central da estrada para marcar claramente o lado da estrada em que o lugar está localizado.
  • restricted_travel_modes é uma lista de modos de transporte que não podem ser acessados pelo ponto de navegação:
    • "DRIVE" é o modo de transporte correspondente às rotas de carro.
    • "WALK" é o meio de transporte correspondente às instruções de caminhada.
  • road_name contém o nome da estrada em que o ponto de navegação está deslocado.

Os pontos de navegação são retornados para a maioria dos lugares com uma localização precisa, como endereços, edifícios e estabelecimentos. Lugares que representam grandes áreas, como cidades e regiões, em que um local preciso pode ser ambíguo, podem não retornar pontos de navegação.

Aviso de migração

A partir de 17 de abril, você precisa fornecer o parâmetro de cálculos extra NAVIGATION_POINTS na solicitação para receber pontos de navegação. Os clientes podem testar isso confirmando que o campo road_name em alguns pontos de navegação é retornado e que o campo location em cada ponto de navegação tem os quatro subcampos a seguir (lat, lng, latitude, longitude).

Além disso, é necessário migrar para os campos location.lat e location.lng em vez de location.latitude e location.longitude. Em uma versão futura, as solicitações que não contêm o parâmetro de cálculos extras NAVIGATION_POINTS não vão incluir pontos de navegação na resposta, e os campos location.latitude e location.longitude não serão mais retornados.

Detalhes da solicitação

É possível receber pontos de navegação nos seguintes tipos de solicitações:

Para qualquer uma dessas solicitações, forneça este parâmetro: extra_computations=NAVIGATION_POINTS.

Exemplo de solicitação

A consulta a seguir usa a geocodificação de lugar para receber pontos de navegação de um restaurante em Mountain View, Califórnia, Estados Unidos:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJZ54APTS3j4ARBYZD956MHq8&extra_computations=NAVIGATION_POINTS&key=YOUR_API_KEY

Exemplo de resposta

A resposta da consulta acima mostra uma matriz de pontos de navegação:

{
  "navigation_points": [
    {
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Castro Street"
    },
    {
      "location": {
        "lat": 37.394273,
        "lng": -122.0793078,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Wild Cherry Lane"
    },
    {
      "location": {
        "lat": 37.3941202,
        "lng": -122.0789189,
      },
      "restricted_travel_modes": ["DRIVE"]
    }
  ]
}

Feedback

Este é um recurso experimental. Envie seu feedback para geocoding-feedback-channel@google.com.