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 les sections de route à proximité, et renvoie un ID de lieu ainsi que des métadonnées telles que la section de route la plus proche et les limites de vitesse.

Pourquoi utiliser l'API Roads ?

Avec l'API Roads, vous pouvez obtenir les limites de vitesse, l'heure d'arrivée estimée ou d'autres métadonnées sur une route. Avec ces métadonnées sur les routes, vous pouvez améliorer vos applications de conduite grâce aux fonctionnalités de suivi:

  • Associez des coordonnées de latitude/longitude avec une route ou des routes.
  • Trouver la route la plus proche pour un ensemble de coordonnées
  • Obtenir des limites de vitesse pour des sections de route

Fonctionnalités de l'API Roads

Avec Roads API, vous pouvez mapper des coordonnées GPS à la géométrie de la route et déterminer la limite de vitesse le long de sections de route.

  • Snap to Roads : ce service renvoie les routes les plus 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 à ce que le service d'interpoler des points supplémentaires, afin d'obtenir un tracé qui suit de façon fluide la géométrie de la route.
  • Routes les plus proches : ce service affiche la section de route la plus proche pour un point GPS. Vous pouvez indiquer jusqu'à 100 points GPS. Les points que vous spécifiez n'ont pas besoin de faire partie d'un tracé continu.
  • Speed limitations (limitation de vitesse) : affiche les limitations de vitesse indiquées pour une section 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 de l'API Roads

L'API Roads utilise trois points de terminaison qui acceptent les coordonnées de latitude/longitude ou les identifiants de lieu pour fournir des données sur les tracés de route, les sections ou les limitations de vitesse. L'exemple suivant montre une requête de 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 et les données qu'elle renvoie.

Ressources de données Données renvoyées Format renvoyé
Suivre les routes

Renvoie un tableau comportant jusqu'à 100 points GPS pour un itinéraire. Inclut les coordonnées de longitude/latitude associées à la route et les ID de lieu. Pour en savoir plus, reportez-vous à 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 identifiants 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, reportez-vous à 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. Ils contiennent les limitations de vitesse et les identifiants de lieu, exprimés en KPH ou MPH. Consultez la section Réponses du guide sur les limitations de vitesse.

Utiliser l'API Roads

1 Essayer la démo "Snap to Roads" Cliquez sur la démo pour créer un tracé et voir comment le point de terminaison "Aligner sur le tracé de la route" fournit des données fluides. Consultez la démonstration du guide Aligner sur les routes. Vous n'avez pas besoin d'une clé API.
2 Configuration Commencez par Configurer votre projet Google Cloud et suivez les instructions de configuration qui suivent, puis découvrez comment utiliser votre clé API.
3 Essayer une requête "Snap to Roads" Utilisez l'un des exemples "Snap to Road" et essayez-en un pertinent pour votre cas d'utilisation.
4 Connaître les limites de vitesse sur votre trajet Envoyez une requête de limite de vitesse à l'aide des données de tracé que vous avez fournies pour votre requête "Snap to Roads". Consultez l'exemple de requête utilisant un chemin d'accès.
5 Découvrez comment traiter les chemins longs. Suivez les sections Traiter des chemins longs du guide Concepts avancés.
6 Intégrez des données routières dans votre propre application. Consultez l'exemple de code détaillé tiré de la démonstration des tracés de route pour commencer à intégrer une fonctionnalité de données routières à 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. Téléchargez-les depuis GitHub, où vous trouverez également des instructions d'installation et des exemples de code.

Étapes suivantes