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. Elle utilise ces points pour trouver des 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, les heures d'arrivée estimées et d'autres métadonnées sur la route. Grâce à ces métadonnées de route, 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 obtenir un ensemble de coordonnées
  • Obtenir des limitations de vitesse pour des sections de route

Ce que vous pouvez faire avec l'API Roads

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 sections de route.

  • Snap to Roads : ce service renvoie les routes les plus probables empruntées en fonction de l'ensemble des coordonnées GPS fournies. Vous pouvez spécifier jusqu'à 100 points GPS collectés sur un itinéraire. Vous pouvez également demander que le service interpole des points d'accès supplémentaires. Le trajet suit alors naturellement la géométrie de la route.
  • Routes les plus proches : ce service renvoie la section de route la plus proche pour un point GPS. Vous pouvez indiquer jusqu'à 100 points GPS. Les points que vous spécifiez ne doivent pas faire partie d'un chemin continu.
  • Limites de vitesse : ce service renvoie la limitation de vitesse indiqué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 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 chemins routiers, les sections de route 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'API Roads, ainsi que les données renvoyées.

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

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

Tableau de 100 coordonnées de latitude/longitude indépendantes maximum avec les identifiants de lieu pour la route la plus proche pour chaque point spécifié. Les points ne doivent pas nécessairement être continus. Pour en savoir plus, consultez la section Réponses du guide Routes les plus proches.
Limites de vitesse

Tableau comportant jusqu'à 100 éléments de métadonnées sur la route. Ils contiennent les limites de vitesse et les identifiants de lieu, avec des unités en KPH ou en MPH. Pour en savoir plus, consultez la section Réponses du guide des Limites de vitesse.

Utiliser l'API Roads

1 Essayer la démo "Snap to Roads" Cliquez sur la démonstration pour créer une piste et voir comment le point de terminaison de l'ancrage vers les routes fournit des données fluides. Consultez la démonstration du guide Aligner sur les routes. Vous n'avez pas besoin de clé API.
2 Configuration Commencez par configurer votre projet Google Cloud, suivez les instructions de configuration ci-dessous, puis découvrez comment utiliser votre clé API.
3 Essayer d'envoyer une demande d'ancrage vers une route Utilisez l'un des exemples de "Snap to Roads" et essayez celui qui correspond à votre cas d'utilisation.
4 Connaître les limites de vitesse sur votre itinéraire Utilisez les mêmes données de tracé que celles que vous avez fournies pour votre requête d'ancrage vers les routes. Consultez l'exemple de requête utilisant un chemin.
5 Découvrez comment traiter les longs chemins. Suivez les sections de la section Traiter des chemins d'accès longs dans le guide Concepts avancés.
6 Intégrez les données sur vos routes dans votre propre application ! Consultez l'exemple de code détaillé de la démonstration sur la route pour commencer à implémenter la fonctionnalité de données sur les routes 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. Téléchargez-les sur GitHub, où vous trouverez également des instructions d'installation et un exemple de code.

Étapes suivantes