Présentation de l'API Roads

L'Roads API est un service qui accepte les requêtes HTTPS avec des coordonnées de latitude/longitude pour un ou plusieurs points sur une carte. Elle utilise ces points pour trouver les segments de route à proximité et renvoie un ID de lieu ainsi que des métadonnées telles que le segment de route le plus proche et les limitations de vitesse.

Pourquoi utiliser le Roads API ?

Avec l'Roads API, vous pouvez obtenir les limitations de vitesse, les heures d'arrivée estimées ou d'autres métadonnées sur les routes. Grâce à ces métadonnées, vous pouvez améliorer vos applications de conduite avec les fonctionnalités suivantes :

  • Associer des coordonnées de latitude/longitude à une ou plusieurs routes
  • Trouver la route la plus proche pour un ensemble de coordonnées
  • Obtenir les limitations de vitesse pour les segments de route

Ce que vous pouvez faire avec l'API Roads API

Avec l'Roads API, vous pouvez mapper les coordonnées GPS à la géométrie de la route et déterminer la limitation de vitesse sur les segments de route.

  • Snap to Roads : ce service renvoie les routes les plus probables en fonction de l'ensemble de coordonnées GPS fourni. Vous pouvez spécifier jusqu'à 100 points GPS collectés le long d'un itinéraire. Vous pouvez également demander au service d'interpoler des points supplémentaires, ce qui donne un chemin qui suit la géométrie de la route en douceur.
  • Nearest Roads : ce service renvoie le segment de route le plus proche pour un point GPS. Vous pouvez spécifier jusqu'à 100 points GPS. Les points que vous spécifiez n'ont pas besoin de faire partie d'un chemin continu.
  • Limitations de vitesse : ce service renvoie la limitation de vitesse indiquée pour un segment de route. Le service "Limitations de vitesse" est disponible pour tous les clients disposant d'une licence Asset Tracking. Pour les clients du forfait Premium Google Maps Platform qui sont passés à la tarification à l'usage, la fonctionnalité reste active.

Fonctionnement de l'Roads API

L'Roads API utilise trois points de terminaison qui acceptent les coordonnées de latitude/longitude ou les ID de lieu pour fournir des données sur les itinéraires, les segments ou les limitations de vitesse. L'exemple suivant montre une requête pour les routes les plus proches en fonction d'un ensemble de coordonnées de latitude/longitude :

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

Ressources

Le tableau suivant récapitule les ressources disponibles via l' Roads API ainsi que les données qu'elle renvoie.

Ressources de données Données renvoyées Format renvoyé
Snap to Roads

Renvoie un tableau contenant jusqu'à 100 points GPS d'un itinéraire. Inclut les coordonnées de longitude/latitude alignées sur la route, ainsi que les ID de lieu. Pour en savoir plus, consultez la section Réponses du guide Snap to Roads.
  • JSON
Nearest Roads

Tableau contenant jusqu'à 100 coordonnées de latitude/longitude indépendantes ainsi que les ID de lieu de la route la plus proche pour chaque point spécifié. Les points n'ont pas besoin d'être continus. Pour en savoir plus, consultez la section Réponses du guide Nearest Roads.
Limitations de vitesse

Tableau contenant jusqu'à 100 éléments de métadonnées sur les routes. Ceux-ci contiennent les limitations de vitesse et les ID de lieu, avec des unités en km/h ou en mph. Pour en savoir plus, consultez la section Réponses du guide Limitations de vitesse.

Comment utiliser Roads API ?

1 Essayez la démo Snap to Roads Cliquez sur la démo pour créer un itinéraire et voir comment le point de terminaison Snap to Roads fournit des données fluides. Consultez la section Démo du guide Snap to Roads. Vous n'avez pas besoin de clé API.
2 Configurer vos écouteurs Commencez par Configurer votre projet Google Cloud, suivez les instructions de configuration et puis découvrez comment utiliser votre clé API.
3 Essayez une requête Snap to Roads Utilisez l'un des exemples Snap to Roads et essayez-en un qui correspond à votre cas d'utilisation.
4 Obtenez les limitations de vitesse pour votre itinéraire À l'aide des mêmes données d'itinéraire que celles que vous avez fournies pour votre requête Snap to Roads, envoyez une requête de limitation de vitesse. Consultez l' exemple de requête utilisant un itinéraire.
5 Découvrez comment traiter les itinéraires longs Suivez les sections sur le traitement des itinéraires longs dans le guide Concepts avancés.
6 Intégrez des données routières dans votre propre application ! Consultez l' exemple de code détaillé de la démo Snap to Roads pour commencer à intégrer des fonctionnalités de données routières dans votre propre application.

Bibliothèques clientes disponibles

Appelez cette API dans le langage de votre choix via l'une des bibliothèques clientes suivantes :

Les clients Java, Python, Go et Node.js pour les services Google Maps sont des bibliothèques clientes alimentées par la communauté, disponibles en Open Source sous la licence Apache 2.0. Vous pouvez les télécharger depuis GitHub, où vous trouverez également des instructions d'installation et un exemple de code.

Étape suivante