Eso es todo.

Para comenzar a desarrollar, consulta nuestra documentación para desarrolladores.

Activar Google Maps Roads API

Para que puedas comenzar, te proporcionaremos orientación en la consola para desarrolladores de Google a fin de que hagas primero algunas acciones:

  1. Crear o seleccionar un proyecto
  2. Activar Google Maps Roads API
  3. Crear claves correspondientes
Continuar

Carreteras más cercanas

La Google Maps Roads API usa hasta 100 coordenadas independientes y muestra el segmento de ruta más cercano para cada punto. Los puntos que se pasan no necesariamente forman parte de una ruta continua.

Si estás trabajando con puntos de GPS secuenciales, usa Snap to Roads.

Solicitudes

Una solicitud de ruta más cercana se debe enviar a través de HTTPS y toma la siguiente forma:

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

Uso de parámetros

Parámetros obligatorios

  • points: lista de pares de latitud y longitud. Los valores de latitud y longitud deben estar separados por comas. Las coordenadas deben estar separadas por el carácter de barra vertical: “|”. For example:points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
  • key: clave de API de tu aplicación. Tu aplicación debe identificarse cada vez que envíe una solicitud a Google Maps Roads API; para ello, debe incluir una clave de la API con cada solicitud. Infórmate acerca de cómo obtener una clave.

Respuestas

Para cada solicitud válida, el método Google Maps Roads API mostrará una respuesta con el formato indicado en la dirección URL de la solicitud. Los siguientes elementos pueden estar presentes en una respuesta de Snap to Roads.

  • snappedPoints: un conjunto de puntos ajustados. Cada punto contiene los siguientes campos:
    • location: contiene un valor latitude y uno longitude.
    • originalIndex: un valor entero que indica el valor correspondiente en la solicitud original. Cada punto en la solicitud representa como máximo dos segmentos en la respuesta:
      • Si no hay rutas cercanas, no se muestran segmentos.
      • Si la ruta más cercana es de una sola dirección, se muestra un segmento.
      • Si la ruta más cercana es bidireccional, se muestran dos segmentos.
    • placeId: un identificador único para un sitio. Todos los id. de sitio devueltos por Google Maps Roads API corresponden a segmentos de la ruta. Los [id. de sitio] se pueden usar con otras API de Google, incluidas Google Places API y Google Maps JavaScript API. Por ejemplo, si necesitas obtener nombres de rutas para los puntos ajustados devueltos por Google Maps Roads API, puedes pasar el placeId a Google Places API o a Google Maps Geocoding API. En la Google Maps Roads API, puedes pasar placeId en una solicitud de límites de velocidad para determinar el límite de velocidad en ese segmento de ruta.

Ejemplo de solicitud

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

Solicitud

https://roads.googleapis.com/v1/nearestRoads?points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796&key=YOUR_API_KEY

Respuesta

{
  "snappedPoints": [
    {
      "location": {
        "latitude": 60.170877918672588,
        "longitude": 24.942699821922421
      },
      "originalIndex": 0,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170876898776406,
        "longitude": 24.942699912064771
      },
      "originalIndex": 1,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170874902634374,
        "longitude": 24.942700088491474
      },
      "originalIndex": 2,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    }
  ]
}

Enviar comentarios sobre...

Google Maps Roads API
Google Maps Roads API
Si necesitas ayuda, visita nuestra página de asistencia.