Carreteras más cercanas

El servicio Roads API toma hasta 100 coordenadas independientes y devuelve el tramo 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 de GPS secuenciales, usa Snap to Roads.

Solicitudes

Las solicitudes a Nearest Roads deben enviarse con HTTPS y tener 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 devuelve un conjunto de tramos de ruta según 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, la Roads API devolverá 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 valores de 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 para un lugar. Todos los IDs de lugar que devuelve la API de Roads corresponden a tramos de ruta.

opcional número

Es un número entero que indica el valor correspondiente en la solicitud original. Cada valor de la solicitud debe asignarse a un valor ajustado en la respuesta. Sin embargo, si estableciste interpolate=true o si usas nearest roads, 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 valor de originalIndex de 4 será el valor ajustado de la 5ª latitud/longitud que se pasa al parámetro de ruta. Los puntos de Nearest Roads pueden contener varios puntos para coordenadas individuales con diferentes ubicaciones o IDs de lugar.

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

Latitud en grados decimales
required número

Longitud en grados decimales