Présentation de l'API Roads

Le Roads API est un service qui accepte les requêtes HTTPS avec les coordonnées de latitude/longitude d'un ou plusieurs points sur une carte. Il utilise ces points pour trouver les sections de route à proximité et renvoie un identifiant de lieu ainsi que des métadonnées comme la section de route la plus proche et les limitations de vitesse.

Pourquoi utiliser l'API Roads ?

Avec l'API Roads, vous pouvez obtenir des limites de vitesse estimées les heures d'arrivée ou d'autres métadonnées de route. Avec cette route métadonnées, 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 au la géométrie de la route et déterminer la limitation de vitesse sur celle-ci ; segments.

  • Aligner sur les routes. Ce service renvoie les résultats routes empruntées sur la base de l'ensemble de coordonnées GPS fourni. Vous pouvez spécifier jusqu'à 100 Points GPS collectés sur l'itinéraire. Vous pouvez également demander au service interpole des points supplémentaires, ce qui permet d'obtenir un tracé qui suit de façon fluide la géométrie de la route.
  • Routes les plus proches : ce service renvoie la 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 les une limitation de vitesse pour une section de route. Le service Speed Limit est accessible à tous qui disposent d'une licence de suivi des ressources. Pour le forfait Premium Google Maps Platform clients qui sont passés au paiement à l'usage, la fonctionnalité reste actif.

Fonctionnement de l'API Roads

L'API Roads utilise trois points de terminaison qui acceptent les coordonnées de latitude/longitude. coordonnées ou identifiants de lieu pour fournir des données sur les chemins, les sections ou les limitations de vitesse. L'exemple suivant illustre 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 le 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 coordonnées de longitude/latitude délimitées par la route le long avec des ID de lieu. Voir les détails dans Réponses dans l'option Suivre le tracé de la route .

  • JSON
Routes les plus proches

Tableau comportant jusqu'à 100 coordonnées de latitude/longitude indépendantes avec les identifiants de lieu de la route la plus proche pour chaque point spécifié. Les points n'ont pas besoin d'être continus. Voir les détails dans Réponses dans les routes les plus proches .

Limites de vitesse

Tableau comportant des métadonnées de route comportant jusqu'à 100 éléments. Ceux-ci indiquent la vitesse les limites et les identifiants de lieu, avec les unités en km/h ou en miles/h. Afficher les détails dans Réponses dans les limitations 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 circuit et voir comment l'option "Aligner sur les routes" fournit des données fluides. Voir Démonstration dans le guide Aligner sur les routes. Vous n'avez pas besoin d'une clé API.
2 Configuration Commencez par Configurer votre votre projet Google Cloud et suivez les instructions de configuration ci-dessous. puis nous découvrirons comment utiliser votre clé API.
3 Essayer une requête "Suivre le tracé de la route" Utilisez l'un des boutons Snap à des exemples de routes et essayez d'en utiliser un adapté à votre cas d'utilisation.
4 Obtenir les limites de vitesse sur votre trajet En utilisant les mêmes données de tracé que celles que vous avez fournies pour votre requête "Aligner sur les routes", une requête de limitation de vitesse. Consultez le Exemple de requête utilisant un chemin d'accès.
5 Découvrez comment traiter les chemins longs. Suivez les sections sur Traiter des chemins d'accès longs dans le guide Concepts avancés.
6 Intégrez des données routières à votre propre application. Consultez le exemple de code détaillé issu de la démonstration d'ancrage de la route pour commencer intégrer des fonctionnalités de données routières dans votre propre application.

Bibliothèques clientes disponibles

Appelez cette API dans le langage de de votre choix via l'une des bibliothèques clientes suivantes:

Les clients Java, Python, Go et Node.js pour Google Maps Les services sont des bibliothèques clientes soutenues par la communauté, disponibles en Open Source dans le cadre du 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