Carreteras más cercanas

La Roads API usa hasta 100 coordenadas independientes y muestra el segmento de ruta más cercano para cada punto. No es necesario que los puntos pasados formen parte de una ruta continua.

Si trabajas con puntos GPS secuenciales, usa Snap to Roads.

Solicitudes

Las solicitudes a las rutas más cercanas deben enviarse con HTTPS y tienen el siguiente formato:

https://roads.googleapis.com/v1/nearestRoads?parameters&key=YOUR_API_KEY

Parámetros obligatorios

  • puntos

    Son los puntos que se ajustarán. El parámetro points acepta una lista de pares de latitud y longitud. Separa los valores de latitud y longitud con comas. Separa las coordenadas con el carácter de barra vertical: "|". Por ejemplo: points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.

Ejemplos

La siguiente solicitud muestra un conjunto de segmentos de ruta en función de la lista de coordenadas especificada.

URL

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://roads.googleapis.com/v1/nearestRoads?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796&key=YOUR_API_KEY'

Respuestas

Para cada solicitud válida, el Roads API mostrará una respuesta en el formato indicado en la URL de la solicitud.

{
  "snappedPoints":
    [
      {
        "location":
          { "latitude": 60.170878428876755, "longitude": 24.94269540970182 },
        "originalIndex": 0,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.17087741412199, "longitude": 24.942695474405202 },
        "originalIndex": 1,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.170875416131736, "longitude": 24.942695601802203 },
        "originalIndex": 2,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
    ],
}

La respuesta usa el siguiente esquema.

NearestRoadsResponse

Campo Obligatorio Tipo Descripción
opcional Array<SnappedPoint>

Es un array de puntos ajustados. A veces, contiene varios puntos ajustados para el mismo punto con diferentes placeId o ubicación.

Consulta SnappedPoint para obtener más información.

SnappedPoint

Campo Obligatorio Tipo Descripción
required LatitudeLongitudeLiteral Consulta LatitudeLongitudeLiteral para obtener más información.
required string

Es un identificador único de un lugar. Todos los IDs de lugar que muestra la API de Roads corresponden a segmentos de ruta.

opcional número

Es un número entero que indica el valor correspondiente en la solicitud original request. Cada valor de la solicitud debe asignarse a un valor ajustado en la respuesta. Sin embargo, si configuraste interpolate=true o si estás usando las rutas más cercanas, es posible que la respuesta contenga más coordenadas que la solicitud. Los valores interpolados no tendrán un originalIndex. Estos valores se indexan desde 0, por lo que un punto con un originalIndex de 4 será el valor ajustado de la quinta latitud o longitud que se pasa al parámetro de ruta. Los puntos de las rutas más cercanas pueden contener varios puntos para coordenadas únicas con diferentes ubicaciones o placeId.

LatitudeLongitudeLiteral

Es un objeto que describe una ubicación específica con latitud y longitud en grados decimales.

Campo Obligatorio Tipo Descripción
required número

Es la latitud en grados decimales.
required número

Es la longitud en grados decimales.