Présentation de l'API Roads

Roads API est un service qui accepte les requêtes HTTPS avec les coordonnées de latitude/longitude d'un ou de 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 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 routières. Grâce à ces métadonnées routières, vous pouvez améliorer vos applications de conduite avec les fonctionnalités suivantes :

  • Associez 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 le Roads API

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

  • Aligner sur les routes : ce service renvoie les routes les plus susceptibles d'avoir été empruntées 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 permet d'obtenir un tracé qui suit parfaitement la géométrie de la route.
  • Nearest Roads : ce service renvoie le segment de route le plus proche d'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.
  • Limites de vitesse : ce service renvoie la limite de vitesse affichée pour un segment de route. Le service Speed Limit est disponible pour tous les clients disposant d'une licence de suivi des ressources. Pour les clients du forfait Premium Google Maps Platform qui sont passés au paiement à l'usage, la fonctionnalité reste active.

Fonctionnement d'Roads API

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 routes, 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 Roads API, ainsi que les données qu'il renvoie.

Ressources de données Données renvoyées Format de retour
Aligner sur les routes

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 Réponses dans le guide Aligner sur les routes.
  • 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 Routes les plus proches.
Limites de vitesse

Tableau contenant jusqu'à 100 éléments de métadonnées de route. Elles contiennent des limitations de vitesse et des 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.

Utiliser le Roads API

1 Essayer la démo de la fonctionnalité Aligner sur les routes Cliquez sur la démonstration pour créer un tracé et voir comment le point de terminaison "Aligner sur les routes" fournit des données lissées. Consultez la section Démo du guide Aligner sur les routes. Vous n'avez pas besoin de clé API.
2 Configurer Commencez par configurer votre projet Google Cloud, suivez les instructions de configuration qui suivent, puis découvrez comment utiliser votre clé API.
3 Essayer une requête d'alignement sur les routes Utilisez l'un des exemples d'alignement sur les routes et essayez-en un qui correspond à votre cas d'utilisation.
4 Obtenir les limitations de vitesse pour votre itinéraire En utilisant les mêmes données de chemin que celles que vous avez fournies pour votre requête d'alignement sur les routes, émettez une requête de limitation de vitesse. Consultez l'exemple de requête utilisant un chemin d'accès.
5 Découvrez comment traiter les chemins d'accès longs. Suivez les sections sur le traitement des chemins d'accès 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émonstration de l'alignement sur la route 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 à l'aide de 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. Téléchargez-les depuis GitHub, où vous trouverez également des instructions d'installation et un exemple de code.

Étape suivante