Se usó la API de Cloud Translation para traducir esta página.

Límites de velocidad

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

No se puede garantizar la precisión de los datos sobre límites de velocidad que devuelve Roads API. Los datos sobre límites de velocidad proporcionados no son en tiempo real y pueden ser estimaciones, no ser precisos, estar incompletos o desactualizados. Consulta los detalles de la cobertura para ver las regiones en las que están disponibles los datos de límites de velocidad.

Solicitudes

Una solicitud de 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

Un parámetro path o placeId
- path: Es una lista de hasta 100 pares de latitud y longitud que representan una ruta. Los valores de latitud y longitud deben estar separados por comas. Los pares de latitud y longitud deben estar separados por el carácter barra: "|". Cuando proporcionas el parámetro path, la API primero ajusta la ruta a la ruta más probable que recorre un vehículo (como lo hace para la solicitud snapToRoads) y, luego, determina el límite de velocidad del tramo de ruta relevante. Si no quieres que la API ajuste la ruta, debes pasar un parámetro placeId como se explica a continuación. En el siguiente ejemplo, se muestra el parámetro path con tres pares de latitud/longitud: path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
- placeId: Los IDs de lugar que representan uno o más tramos de ruta. Asegúrate de que cada ID de lugar haga referencia a un tramo de ruta y no a un tipo de lugar diferente. Puedes pasar hasta 100 IDs de lugares con cada solicitud. La API no realiza el ajuste de rutas en los IDs de lugares proporcionados. La respuesta incluye un límite de velocidad para cada ID de lugar en la solicitud. Puedes enviar una solicitud snapToRoads o nearestRoads para encontrar los IDs de lugares relevantes y, luego, proporcionarlos como entrada a la solicitud speedLimits. En el siguiente ejemplo, se muestra el parámetro placeId con dos IDs de lugar: placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU
key: Es la clave de API de tu aplicación. Tu aplicación debe identificarse cada vez que envíe una solicitud a Roads API. Para ello, debe incluir una clave de API con cada solicitud. Obtén más información para 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. Puede ser KPH o MPH. La configuración predeterminada es KPH.

Respuestas

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

speedLimits: Es un array de metadatos de la ruta. Cada elemento contiene los siguientes campos:
- placeId: Es un identificador único para un lugar. Todos los IDs de lugar que devuelva Roads API corresponderán a segmentos de ruta.
- speedLimit: Es el límite de velocidad para ese tramo de ruta.
- units: Muestra KPH o MPH.
snappedPoints: Es un array de puntos ajustados. Este array solo está presente si la solicitud contiene un parámetro path. Cada punto contiene los siguientes campos:
- location: Contiene un valor latitude y longitude.
- originalIndex: Es un número entero que indica el valor correspondiente en la solicitud original. Cada valor en la solicitud debe conducir a un valor ajustado en la respuesta. Estos 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: Es un identificador único para un lugar. Todos los IDs de lugar que devuelva Roads API corresponderán a segmentos de ruta. Se puede pasar placeId en una solicitud de límites de velocidad para determinar el límite de velocidad en ese tramo de ruta.
warning_message: Es una cadena que contiene una advertencia visible para el usuario.

Ejemplo de solicitud con una ruta

Esta solicitud obtiene el límite de velocidad de cada tramo de ruta más cercano a los pares de latitud/longitud especificados en una ruta que cruza el puente Vasco da Gama en Lisboa, Portugal.

Solicitud

https://roads.googleapis.com/v1/speedLimits?path=38.75807927603043,-9.03741754643809|38.6896537,-9.1770515|41.1399289,-8.6094075&key=YOUR_API_KEY

Respuesta

{
  speedLimits:
  [
    {
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE",
      speedLimit: 105,
      units: "KPH"
    },
    {
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU",
      speedLimit: 70,
      units: "KPH"
    },
    {
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M",
      speedLimit: 55,
      units: "KPH"
    }
  ],
  snappedPoints:
  [
    {
      location:
      {
        latitude: 38.75807927603043,
        longitude: -9.037417546438084
      },
      originalIndex: 0,
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE"
    },
    {
      location:
      {
        latitude: 38.689653701836896,
        longitude: -9.177051486847693
      },
      originalIndex: 1,
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU"
    },
    {
      location:
      {
        latitude: 41.13993011767777,
        longitude: -8.609400794783655
      },
      originalIndex: 2,
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M"
    }
  ],
  warningMessage: "Input path is too sparse. You should provide a path where consecutive points are closer to each other. Refer to the 'path' parameter in Google Roads API documentation."
}

Observa el mensaje de advertencia sobre la dispersión de puntos en la respuesta anterior. Si solicitas límites de velocidad para los tramos de ruta más cercanos en puntos arbitrarios, debes llamar a speedLimits con los IDs de lugares recuperados del extremo nearestRoads.

Ejemplo de solicitud con IDs de lugar

En lugar de usar pares de latitud/longitud, puedes pasar los IDs de los lugares de los segmentos de ruta. Te recomendamos que obtengas los IDs de lugares para los tramos de ruta con solicitudes snapToRoads o nearestRoads. Cuando pasas los IDs de lugar, la API muestra el límite de velocidad del tramo de ruta que representa cada ID de lugar. La API no aplica ningún ajuste a las rutas a los IDs de lugares proporcionados.

En el siguiente ejemplo, se solicitan los límites de velocidad de algunos de los tramos de ruta que cruzan el puente Vasco da Gama en Lisboa, Portugal.

Solicitud

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU&placeId=ChIJJ4vQRudkJA0RpednU70A-5M&key=YOUR_API_KEY

Respuesta

{
  "speedLimits": [
    {
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE",
      speedLimit: 105,
      units: "KPH"
    },
    {
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU",
      speedLimit: 70,
      units: "KPH"
    },
    {
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M",
      speedLimit: 55,
      units: "KPH"
    }
  ]
}

Recomendaciones de uso

Para minimizar el volumen de llamadas al servicio Speed Limit, te recomendamos que tomes muestras de las ubicaciones de tus recursos en intervalos de 5 a 15 minutos (el valor exacto depende de la velocidad a la que se desplaza un recurso). Si un recurso es fijo, basta con tomar una sola muestra de la ubicación (no es necesario realizar varias llamadas).

Para minimizar la latencia general, recomendamos llamar al servicio Speed Limit una vez que hayas acumulado algunos datos, en lugar de llamar a la API cada vez que se reciba la ubicación de un recurso móvil.

¿Por qué faltan algunos o todos los límites de velocidad?

La causa más común por la que falta speedLimits es solicitar el límite de velocidad de un lugar que no es un tramo de ruta.

En el ejemplo anterior, se usa el puente Vasco da Gama para ilustrar los conceptos. El puente admite la ruta E90 que cruza el río Tajo. El puente tiene un ID de lugar de ChIJUzt97ZEwGQ0RM1JzQfqoDtU. El primer tramo de ruta de la respuesta anterior forma parte de la ruta E90 y tiene un ID de lugar de ChIJX12duJAwGQ0Ra0d4Oi4jOGE. En la solicitud de ejemplo, si reemplazas el ID de lugar de la ruta por el ID de lugar del puente, en la respuesta solo habrá dos límites de velocidad en el array speedLimits porque el ID de lugar del puente no hace referencia a un tramo de ruta individual. Además, si ninguno de los IDs de lugar corresponde a segmentos de ruta, la respuesta no contendrá límites de velocidad.

Cuando realices solicitudes de límite de velocidad con IDs de lugares, asegúrate de que cada ID de lugar se refiera a un tramo de ruta y no a un tipo de lugar diferente. Los IDs de lugares de segmentos de ruta individuales se recuperan mejor con solicitudes snapToRoads o nearestRoads, cualquiera de las cuales puede mostrar varios IDs de lugares desde una sola llamada.