Pontos de navegação

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

O campo navigation_points na resposta de geocodificação contém uma lista de pontos úteis para navegar até o lugar. Especificamente, eles devem ser usados como pontos de partida ou de chegada ao traçar rotas em uma rede viária de ou para o local. 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 perto da rede viária e representa um ponto de parada ou de partida ideal para navegar até e de um lugar. O ponto é intencionalmente ligeiramente deslocado da linha central da via para marcar claramente o lado da via em que o lugar está localizado.
  • restricted_travel_modes é uma lista de modos de viagem que não podem ser usados para acessar o ponto de navegação:
    • "DRIVE" é o meio de transporte correspondente às rotas de carro.
    • "WALK" é o meio de transporte correspondente às rotas a pé.
  • road_name contém o nome da via em que o ponto de navegação está deslocado.

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

Aviso de migração

A partir de 17 de abril, você precisa fornecer o parâmetro NAVIGATION_POINTS extra computations 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, migre 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 contiverem o parâmetro NAVIGATION_POINTS de cálculos extras não incluirão 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 obter 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. Agradecemos seu feedback em geocoding-feedback-channel@google.com.