Carreteras más cercanas

Roads API usa hasta 100 coordenadas independientes y muestra el segmento de ruta más cercano para cada punto. Los puntos pasados no necesitan formar parte de una ruta continua.

Si trabajas con puntos de GPS secuenciales, usa Ajustar a rutas.

Solicitudes

Las solicitudes a las rutas más cercanas deben enviarse a través de 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 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, 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 Es un array de 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 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 configuraste interpolate=true o si usas 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 a partir de 0, por lo que un punto con un originalIndex de 4 será el valor ajustado de la 5ª latitud o longitud que se pasó al parámetro path. 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

Latitud en grados decimales
required número

Longitud en grados decimales