Le Roads API renvoie les limitations de vitesse indiquées pour une route donnée. segment. Dans le cas de sections de route dont la limitation de vitesse est variable, la limitation de vitesse applicable au segment est renvoyée.
Précision des données de limitation de vitesse renvoyées par Roads API ne peut pas être garanti. Les données de limitation de vitesse ne sont pas fournies en temps réel et peuvent être estimées, inexactes, incomplètes et/ou obsolètes. Consultez les détails de la couverture. pour voir les régions où ces données sont disponibles.
Demandes
Les demandes de limites de vitesse doivent être envoyées via HTTPS et se présentent sous la forme suivante:
https://roads.googleapis.com/v1/speedLimits?parameters&key=YOUR_API_KEY
Utilisation des paramètres
Paramètres obligatoires
- Paramètre
path
ouplaceId
.path
: liste de 100 paires de latitude/longitude au maximum représentant un chemin d'accès. Les valeurs de latitude et de longitude doivent être séparées par une virgule. Les paires latitude/longitude doivent être séparées par une barre verticale : "|". Lorsque vous fournissez le paramètrepath
, l'API ancre d'abord le chemin d'accès à la route la plus probable empruntée par un véhicule (comme c'est le cassnapToRoads
), puis détermine la limitation de vitesse la section de route pertinente. Si vous ne voulez pas que l'API ancre le chemin, doit transmettre un paramètreplaceId
comme expliqué ci-dessous. L'exemple suivant affiche le paramètrepath
avec trois paires de latitude/longitude:path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796
placeId
: ID de lieu représentant une ou plusieurs sections de route. Assurez-vous que chaque ID de lieu correspond à une section de route et non à un type différent de l'emplacement. Vous pouvez transmettre jusqu'à 100 ID de lieu avec chacun requête. L'API n'effectue pas d'ancrage des routes sur les ID de lieu fournis. La réponse inclut une limitation de vitesse pour chaque identifiant de lieu de la requête. Vous pouvez envoyer une demandesnapToRoads
ounearestRoads
pour trouver les identifiants de lieu appropriés, puis fournissez-les en tant qu'entrées à la fonctionspeedLimits
. L'exemple suivant montre ParamètreplaceId
avec deux ID de lieu:placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU
key
: clé API de votre application. Votre l'application doit s'identifier chaque fois qu'elle envoie une requête Roads API en incluant une clé API dans chaque requête. Découvrez comment obtenir une clé.
Paramètres facultatifs
units
: indique si la limitation de vitesse doit être renvoyée en kilomètres ou en miles par. heure. Cette valeur peut être définie surKPH
ouMPH
. La valeur par défaut estKPH
.
Réponses
Une réponse speedLimits
peut contenir les éléments suivants:
speedLimits
: tableau de métadonnées d'une route. Chaque élément se compose du les champs suivants:placeId
: identifiant unique d'un lieu. Tous les ID de lieu ont été renvoyés par le Roads API correspondent à des sections de route.speedLimit
: limitation de vitesse pour cette section de route.units
: renvoieKPH
ouMPH
.
snappedPoints
: tableau de points ancrés. Ce tableau est présent uniquement si la requête contenait un paramètrepath
. Chaque point se compose de les champs suivants:location
: contient une valeurlatitude
etlongitude
.originalIndex
: entier indiquant la valeur correspondante dans la requête initiale. Chaque valeur de la requête doit correspondre à un ancrée dans la réponse. Ces valeurs sont indexées à partir de0
. Par conséquent, point avec uneoriginalIndex
de4
sera la valeur ancrée du cinquième coordonnées de latitude/longitude transmises au paramètrepath
.placeId
: identifiant unique d'un lieu. Tous les ID de lieu ont été renvoyés par le Roads API correspondent à des sections de route. LeplaceId
peut être transmis dans une requête de limitation de vitesse pour déterminer une limitation de vitesse sur cette section de route.
warning_message
: chaîne contenant un avertissement visible par l'utilisateur.
Exemple de requête utilisant un chemin d'accès
Cette demande obtient la limitation de vitesse pour chaque section de route la plus proche du paires latitude/longitude spécifiées sur un trajet traversant la Vasco da Gama à Lisbonne, au Portugal.
Requête
https://roads.googleapis.com/v1/speedLimits?path=38.75807927603043,-9.03741754643809|38.6896537,-9.1770515|41.1399289,-8.6094075&key=YOUR_API_KEY
Réponse
{ 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." }
Notez le message d'avertissement concernant la parcimonie de points dans la réponse ci-dessus. Si vous
demandent des limites de vitesse pour les sections de route les plus proches à des points arbitraires ;
vous devez appeler speedLimits
avec des ID de lieu récupérés à partir de
nearestRoads
à la place.
Exemple de requête utilisant des ID de lieu
Au lieu d'utiliser des paires latitude/longitude, vous pouvez transmettre les identifiants de lieu du
les sections de route. Nous vous recommandons d'obtenir des identifiants de lieu pour les sections de route via
Requêtes snapToRoads
ou nearestRoads
. Lorsque vous transmettez des ID de lieu, l'API
renvoie la limitation de vitesse pour la section de route représentée par chaque identifiant de lieu. La
L'API n'applique pas d'ancrage de route aux ID de lieu fournis.
L'exemple suivant demande les limites de vitesse pour certaines sections de route. qui traversent le pont Vasco da Gama à Lisbonne, au Portugal.
Requête
https://roads.googleapis.com/v1/speedLimits?placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU&placeId=ChIJJ4vQRudkJA0RpednU70A-5M&key=YOUR_API_KEY
Réponse
{ "speedLimits": [ { placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE", speedLimit: 105, units: "KPH" }, { placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU", speedLimit: 70, units: "KPH" }, { placeId: "ChIJJ4vQRudkJA0RpednU70A-5M", speedLimit: 55, units: "KPH" } ] }
Recommandations d'utilisation
Pour réduire le volume d'appels au service Speed Limit, nous vous recommandons en échantillonnant l'emplacement de vos éléments à intervalles de 5 à 15 minutes (ce qui correspond dépend de la vitesse de déplacement de l'élément). Si un élément est fixe, un seul échantillon d'emplacements est suffisant (il n'est pas nécessaire de plusieurs appels).
Pour minimiser la latence globale, nous vous recommandons d'appeler le service Speed Limit une fois que vous avez collecté des données au lieu d'appeler l'API chaque fois que vous recevez l'emplacement d'une ressource en mouvement.
Pourquoi certaines ou toutes les limites de vitesse n'apparaissent-elles pas ?
La limitation de vitesse est la cause la plus courante de l'absence de speedLimits
.
d'un lieu qui n'est pas une section de route.
L'exemple ci-dessus utilise le pont Vasco da Gama pour illustrer des concepts.
le pont soutient la route E90 qui passe
au-dessus du Rio Tejo. Pont
possède l'identifiant de lieu ChIJUzt97ZEwGQ0RM1JzQfqoDtU. La première section de route
dans la réponse ci-dessus fait partie de la route E90 et possède l'identifiant de lieu
ChIJX12duJAwGQ0Ra0d4Oi4jOGE. Dans l'exemple de requête, si vous remplacez la route
par l'identifiant de lieu du pont, la réponse contient uniquement
deux limitations de vitesse dans le tableau speedLimits
, car l'ID de lieu du pont
ne désigne pas une section de route individuelle. En outre, si aucune des
les ID de lieu concernent des sections de route, la réponse ne contiendra
les limites de vitesse.
Lorsque vous envoyez des demandes de limitation de vitesse à l'aide d'identifiants de lieu, assurez-vous que chaque identifiant de lieu
désigne une section de route et non un autre type de lieu. ID de lieu pour
Pour extraire les sections de route individuelles de snapToRoads
,
ou nearestRoads
, qui peuvent toutes deux renvoyer plusieurs ID de lieu
un seul appel.