Présentation de l'API Roads

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. Il utilise ces points pour trouver des 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 limites de vitesse.

Pourquoi utiliser l'API Roads ?

Avec l'API Roads, vous pouvez obtenir des limites de vitesse, des heures d'arrivée estimées ou d'autres métadonnées sur les routes. Grâce à ces métadonnées sur les routes, 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 des segments de route

Ce que vous pouvez faire avec l'API Roads

Avec Roads API, vous pouvez faire correspondre les coordonnées GPS à la géométrie de la route et déterminer la limite de vitesse sur les segments de route.

  • Aligner sur les routes : ce service renvoie les routes les plus probables empruntées en fonction de l'ensemble de coordonnées GPS fourni. Vous pouvez spécifier jusqu'à 100 points GPS collectés sur un itinéraire. Vous pouvez également demander au service d'interpoler des points supplémentaires, ce qui permet d'obtenir un tracé qui suit de manière fluide la géométrie de la route.
  • Nearest Roads (Routes les plus proches) : ce service renvoie le tronçon de route le plus proche d'un point GPS. Vous pouvez spécifier jusqu'à 100 points GPS. Les points que vous spécifiez ne doivent pas nécessairement 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 de limitation de vitesse est disponible pour tous les clients disposant d'une licence de suivi des actifs. Pour les clients du forfait Premium Google Maps Platform qui sont passés au modèle de paiement à l'usage, cette fonctionnalité reste active.

Fonctionnement de l'API Roads

L'API Roads utilise trois points de terminaison qui acceptent des coordonnées de latitude/longitude ou des ID de lieu pour fournir des itinéraires routiers, des segments ou des données de limite 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'API Roads, ainsi que les données qu'elle renvoie.

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

Renvoie un tableau de 100 points GPS maximum à partir d'un itinéraire. Inclut les coordonnées de latitude/longitude arrondies à la route, ainsi que les ID de lieu. Pour en savoir plus, consultez la section Réponses du guide Aligner sur les routes.
  • JSON
Routes les plus proches

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.
Limitations de vitesse

Tableau contenant jusqu'à 100 éléments de métadonnées sur les routes. Ils contiennent des limites 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 sur les limites de vitesse.

Utiliser l'API Roads

1 Essayer la démo de l'ancrage sur les routes Cliquez sur la démonstration pour créer un parcours et voir comment le point de terminaison "Ajuster aux routes" fournit des données fluides. Consultez la démonstration dans le guide Ancrer sur les routes. Vous n'avez pas besoin d'une clé API.
2 Configuration Commencez par Configurer votre projet Google Cloud, puis suivez les instructions de configuration qui suivent. Découvrez ensuite comment utiliser votre clé API.
3 Essayez une requête d'ancrage sur les routes Utilisez l'un des exemples d'ancrage sur les routes et essayez-en un qui correspond à votre cas d'utilisation.
4 Obtenir les limitations de vitesse pour votre itinéraire routier À l'aide des mêmes données de parcours que celles que vous avez fournies pour votre requête d'ancrage sur les routes, envoyez une requête de limitation de vitesse. Consultez l'exemple de requête à l'aide d'un chemin d'accès.
5 Découvrez comment traiter les chemins longs. Suivez les sections sur le traitement des chemins longs dans le guide Concepts avancés.
6 Intégrez des données routières à votre propre application ! Consultez l'exemple de code détaillé de la démo de la route capturée pour commencer à intégrer la fonctionnalité de données routières dans votre propre application.

Bibliothèques clientes disponibles

Appelez cette API dans la langue 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. Téléchargez-les sur GitHub, où vous trouverez également des instructions d'installation et un exemple de code.

Étape suivante