Pontos de navegação

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

O campo navigation_points na resposta da API Geocoding contém uma lista de pontos úteis para navegar até o local. Especificamente, eles precisam 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 estará muito próximo da rede viária e representa um ponto de parada ou de partida ideal para navegar de e para um local. O ponto é intencionalmente ligeiramente deslocado da linha central da estrada para marcar claramente o lado da estrada em que o local está localizado.
  • restricted_travel_modes é uma lista de meios de transporte que não podem 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 estrada em que o ponto de navegação está deslocado.

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

Aviso de migração

A partir de 17 de abril, você precisa fornecer o parâmetro de cálculos extras 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 dos campos location.latitude e location.longitude. Em uma versão futura release, as solicitações que não contêm o NAVIGATION_POINTS parâmetro de cálculos extras não vão incluir pontos de navegação na resposta, e os location.latitude e location.longitude campos 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. Agradecemos o feedback em geocoding-feedback-channel@google.com.