Puntos de navegación

El campo navigation_points dentro de la respuesta de la geocodificación contiene una lista de puntos que son útiles para navegar al lugar. Específicamente, se deben usar como puntos de partida o de destino cuando se planifica una ruta en una red de carreteras desde o hacia el lugar. Cada punto de navegación contiene los siguientes valores:

  • location contiene los valores de latitud y longitud del punto de navegación. Esta ubicación siempre estará muy cerca de la red de carreteras y representa un punto de partida o de destino ideal para navegar hacia o desde un lugar. El punto se desplaza intencionalmente un poco de la línea central de la ruta para marcar claramente el lado de la ruta en el que se encuentra el lugar.
  • restricted_travel_modes es una lista de modos de viaje a los que no se puede acceder desde el punto de navegación:
    • "DRIVE" es el modo de viaje que corresponde a las instrucciones sobre cómo llegar en automóvil.
    • "WALK" es el modo de viaje que corresponde a las instrucciones sobre cómo caminar.
  • road_name contiene el nombre de la ruta de la que se desplaza el punto de navegación.

Los puntos de navegación se muestran para la mayoría de los lugares con una ubicación precisa, como direcciones, edificios y establecimientos. Es posible que los lugares que representan áreas grandes, como ciudades y regiones, en las que una ubicación precisa puede ser ambigua, no muestren ningún punto de navegación.

Aviso de migración

A partir del 17 de abril, debes proporcionar el parámetro de procesamiento adicional NAVIGATION_POINTS en la solicitud para recibir puntos de navegación. Los clientes pueden probar esto confirmando que se devuelve el campo road_name dentro de algunos puntos de navegación y que el campo location dentro de cada punto de navegación tenga los siguientes cuatro subcampos (lat, lng, latitude y longitude).

Además, debes migrar a los campos location.lat y location.lng en lugar de los campos location.latitude y location.longitude. En una versión futura, las solicitudes que no contengan el parámetro de procesamiento adicional NAVIGATION_POINTS no incluirán ningún punto de navegación en la respuesta y ya no se mostrarán los campos location.latitude y location.longitude.

Detalles de la solicitud

Puedes obtener puntos de navegación en los siguientes tipos de solicitudes:

Para cualquiera de estas solicitudes, debes proporcionar este parámetro: extra_computations=NAVIGATION_POINTS.

Ejemplo de solicitud

En la siguiente consulta, se usa la geocodificación de lugares para obtener puntos de navegación de un restaurante en Mountain View, California, Estados Unidos:

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

Ejemplo de respuesta

La respuesta de la consulta anterior muestra un array de puntos de navegación:

{
  "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"]
    }
  ]
}

Comentarios

Esta función se encuentra en fase experimental. Agradecemos tus comentarios en geocoding-feedback-channel@google.com.