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 tronçons de route à proximité et renvoie un ID de lieu ainsi que des métadonnées telles que le tronçon de route le plus proche et les limitations de vitesse.

Pourquoi utiliser Roads API ?

Avec Roads API, vous pouvez obtenir des informations sur 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 routières, vous pouvez améliorer vos applications de conduite en leur ajoutant 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

Actions possibles avec Roads API

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

  • Accrocher à la route : 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 chemin qui suit la géométrie de la route de manière fluide.
  • 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 de limitation de vitesse 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 à la tarification à l'usage, la fonctionnalité reste active.

Fonctionnement de Roads API

Roads API utilise trois points de terminaison qui acceptent les coordonnées de latitude/longitude ou les ID de lieux pour fournir des informations 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'elles renvoient.

Ressources de données Données renvoyées Format de retour
Suivre le tracé de la route

Renvoie un tableau contenant jusqu'à 100 points GPS d'un itinéraire. Inclut les coordonnées de longitude/latitude ajustées à la route, ainsi que les ID de lieu. Pour en savoir plus, consultez la section Réponses du 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.
Limitations de vitesse

Tableau contenant jusqu'à 100 éléments de métadonnées routières. Elles contiennent des limites de vitesse et des ID de lieux, avec des unités en km/h ou mph. Pour en savoir plus, consultez la section Réponses du guide Limites de vitesse.

Utiliser Roads API

1 Essayer la démo d'accrochage aux routes Cliquez sur la démo pour créer une trace et voir comment le point de terminaison d'accrochage aux routes fournit des données fluides. Consultez la démonstration dans le guide Ancrer aux routes. Vous n'avez pas besoin de clé API.
2 Configurer Commencez par configurer votre projet Google Cloud, puis suivez les instructions de configuration, et enfin découvrez comment utiliser votre clé API.
3 Essayer une requête d'accrochage aux routes Utilisez l'un des exemples d'accrochage aux routes et essayez-en un qui correspond à votre cas d'utilisation.
4 Afficher les limitations de vitesse sur votre itinéraire À l'aide des mêmes données de chemin que celles que vous avez fournies pour votre demande d'accrochage aux 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 longs chemins. Suivez les sections sur le traitement des longs chemins d'accès 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 d'accrochage à la route pour commencer à intégrer des fonctionnalités de données routières à 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