Pourquoi utiliser l'API Roads ?
Avec l'API Roads, vous pouvez obtenir les limites de vitesse, les heures d'arrivée estimées ou d'autres métadonnées sur les routes. Avec ces métadonnées sur les routes, vous pouvez améliorer vos applications de conduite avec les fonctionnalités suivantes:
- Connectez les coordonnées de latitude/longitude à une ou plusieurs routes.
- Trouver la route la plus proche pour obtenir un ensemble de coordonnées
- Obtenir les limites de vitesse pour les sections de route
Ce que vous pouvez faire avec l'API Roads
Avec le Roads API, vous pouvez mapper des coordonnées GPS avec 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 sur la base des coordonnées GPS fournies. 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 de façon fluide la géométrie de la route.
- Nearest Roads (Routes les plus proches) : ce service renvoie la section de route la 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 tracé continu.
- Limites de vitesse : ce service renvoie la limitation de vitesse indiquée 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 disposant du forfait Premium Google Maps Platform qui est passé 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 ID de lieu pour fournir des données sur les tracés, les sections ou les limites 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 et les données qu'elle renvoie.
Ressources de données | Données renvoyées | Format de retour |
---|---|---|
Suivre le tracé de la route |
Renvoie un tableau comportant jusqu'à 100 points GPS pour un itinéraire. Inclut les coordonnées de longitude et de latitude capturées sur la route, ainsi que les ID de lieu. Pour en savoir plus, consultez la section Réponses du guide Aligner sur les routes. |
|
Routes les plus proches |
Tableau contenant jusqu'à 100 coordonnées de latitude/longitude indépendantes avec des identifiants de lieu pour 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 comportant des métadonnées de route comportant jusqu'à 100 éléments. Ceux-ci contiennent les limitations de vitesse et les identifiants 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 | Essayez la démo "Suivre le tracé de la route" | 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 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, suivez les instructions de configuration ci-dessous, puis découvrez comment utiliser votre clé API. |
3 | Essayer une requête "Suivre le tracé de la route" | Utilisez l'un des exemples Aligner sur les routes et essayez-en un adapté à votre cas d'utilisation. |
4 | Obtenir les limites de vitesse sur votre trajet | À l'aide des mêmes données de chemin que celles que vous avez fournies pour votre requête "Aligner sur les routes", envoyez une requête de limitation de vitesse. Consultez l'exemple de requête utilisant un chemin d'accès. |
5 | Découvrez comment traiter des chemins d'accès longs. | Suivez les sections Traiter des chemins d'accès longs du 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émonstration de l'ancrage de la route pour commencer à créer une fonctionnalité de données routières 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:
- Client Java pour les services Google Maps
- Client Python pour les services Google Maps
- Client Go pour les services Google Maps
- Client Node.js pour les services Google Maps
Les clients Java, Python, Go et Node.js pour les services Google Maps sont des bibliothèques clientes géré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.
Étapes suivantes
- Essayer l'API Roads: accédez à Roads Inspector
- Découvrez comment envoyer des requêtes API Roads. Accédez au service qui vous intéresse :
- Comprendre les concepts avancés: accédez à la section Concepts avancés
- Suivez les bonnes pratiques: consultez Bonnes pratiques concernant les services Web.