Puntos de navegación

Desarrolladores del Espacio Económico Europeo (EEE)

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

  • location contiene el valor de latitud y longitud del punto de navegación. Esta ubicación siempre estará muy cerca de la red de rutas y representa un punto de partida o parada ideal para navegar hacia un lugar y desde él. El punto se desplaza intencionalmente un poco del centro 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 desde los que no se puede acceder al punto de navegación:
    • "DRIVE" es el modo de viaje correspondiente a las instrucciones sobre cómo llegar en automóvil.
    • "WALK" es el modo de viaje correspondiente a las indicaciones para llegar a pie.
  • road_name contiene el nombre de la ruta desde 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 de calles, edificios y establecimientos. Es posible que los lugares que representan áreas grandes, como ciudades y regiones, en los 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, deberás proporcionar el parámetro de NAVIGATION_POINTS cálculos adicionales 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 tiene los siguientes cuatro subcampos (lat, lng, latitude, longitude).

Además, debes migrar a los campos location.lat y location.lng en lugar de a los campos location.latitude y location.longitude. En una versión futura, las solicitudes que no contengan el parámetro de cálculos adicionales NAVIGATION_POINTS no incluirán ningún punto de navegación en la respuesta, y ya no se devolverá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

La siguiente consulta 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. Agradeceríamos tus comentarios en geocoding-feedback-channel@google.com.