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

Límites de velocidad

Nota: El servicio de límite de velocidad solo está disponible para clientes de Google Maps APIs Premium Plan con una licencia de seguimiento de recursos.

La Google Maps Roads API muestra el límite de velocidad publicado para un segmento de ruta determinado. En el caso de segmentos de ruta con límites de velocidad variables, se devuelve el límite de velocidad predeterminado para ese segmento.

La precisión de los datos sobre límites de velocidad devueltos por Google Maps Roads API no se puede garantizar. Los datos sobre límites de velocidad proporcionados no son en tiempo real y pueden ser cálculos aproximados, no ser precisos, estar incompletos o desactualizados. Las imprecisiones en nuestros datos pueden informarse a través del servicio Google Map Maker.

Solicitudes

Una solicitud para límites de velocidad se debe enviar a través de HTTPS y toma la siguiente forma:

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

Uso de parámetros

Parámetros obligatorios

  • Ya sea un parámetropath o uno o más placeId.
    • path: el trayecto que se debe ajustar. El parámetro path acepta una lista de pares de latitud/longitud. Los valores de latitud y longitud deben estar separados por comas. Las coordenadas deben estar separadas por el carácter de barra vertical “|”. Por ejemplo: path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
    • placeId: el id. de sitio para el segmento de ruta. Se muestran ID de sitio en respuesta a las solicitudes snapToRoads y nearestRoads. Puedes pasar hasta 100placeId con cada solicitud.
  • 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.

Parámetros opcionales

  • units: indica si los límites de velocidad se deben devolver en kilómetros o en millas por hora. Este parámetro puede configurarse en KPH o MPH. El valor predeterminado es KPH.

Puedes solicitar datos sobre el límite de velocidad usando un path o una serie de placeId; no obstante, solo recibirás una respuesta para cada placeId individual en la solicitud. Puede haber placeId duplicados cuando hay varios puntos en una distancia corta.

Respuestas

Los siguientes elementos pueden estar presentes en una respuesta de speedLimits:

  • speedLimits: un conjunto de metadatos de la ruta. Cada elemento contiene los siguientes campos:
    • placeId: un identificador único para un sitio. Todos los placeId devueltos por Google Maps Roads API corresponden a segmentos de la ruta.
    • speedLimit: el límite de velocidad para ese segmento de la ruta.
    • units: devuelve KPH o MPH.
  • snappedPoints: un arreglo de puntos ajustados. Este conjunto solo estará presente si la solicitud contiene un parámetro path. 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 valor en la solicitud debe conducir a un valor ajustado en la respuesta. Esos valores se indexan desde 0, por lo que un punto con un originalIndex de 4 será el valor ajustado de la quinta latitud/longitud que se le pasa al parámetro path.
    • placeId: un identificador único para un sitio. Todos los placeId devueltos por Google Maps Roads API corresponden a segmentos de la ruta. placeId se puede pasar 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 determinará los límites de velocidad para un trayecto corto de ruta en Canberra, Australia.

Solicitud

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJ1Wi6I2pNFmsRQL9GbW7qABM
        &placeId=ChIJ58xCoGlNFmsRUEZUbW7qABM
        &placeId=ChIJ9RhaiGlNFmsR0IxAbW7qABM
        &placeId=ChIJabjuhGlNFmsREIxAbW7qABM
        &placeId=ChIJcSAlFWpNFmsRMHlUbW7qABM
        &placeId=ChIJI2FUTGhNFmsRcHpAbW7qABM
        &placeId=ChIJiy6YT2hNFmsRkHZAbW7qABM
        &placeId=ChIJoR7CemhNFmsRQB9QbW7qABM
        &placeId=ChIJP2m_FWpNFmsRIHlUbW7qABM
        &placeId=ChIJtV7La2pNFmsRAGpHbW7qABM
        &placeId=ChIJW5JAZmpNFmsRegG0-Jc80sM
        &placeId=ChIJW9R7smlNFmsRMH1AbW7qABM
        &placeId=ChIJy8c0r2lNFmsRQEZUbW7qABM
        &key=YOUR_API_KEY

Respuesta

{
  "speedLimits": [
    {
      "placeId": "ChIJ1Wi6I2pNFmsRQL9GbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ58xCoGlNFmsRUEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ9RhaiGlNFmsR0IxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJabjuhGlNFmsREIxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJcSAlFWpNFmsRMHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJI2FUTGhNFmsRcHpAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJiy6YT2hNFmsRkHZAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJoR7CemhNFmsRQB9QbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJP2m_FWpNFmsRIHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJtV7La2pNFmsRAGpHbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW5JAZmpNFmsRegG0-Jc80sM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW9R7smlNFmsRMH1AbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJy8c0r2lNFmsRQEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    }
  ]
}

Enviar comentarios sobre…

Google Maps Roads API
Google Maps Roads API
¿Necesitas ayuda? Visita nuestra página de asistencia.