Vous êtes prêt !

Pour passer à l'étape de développement, accédez à notre documentation pour les développeurs.

Activer Google Maps Roads API

Pour commencer, nous allons vous guider à travers la console Google Developers et effectuer deux ou trois petites choses :

  1. Créer ou sélectionner un projet
  2. Activer Google Maps Roads API
  3. Créer les clés appropriées
Continuer

Routes les plus proches

Google Maps Roads API utilise jusqu'à 100 coordonnées indépendantes et renvoie le segment de route le plus proche pour chaque point. Il n'est pas nécessaire que les points transmis fassent partie d'un tracé continu.

Si vous utilisez des points GPS séquentiels, utilisez Snap to Roads.

Requêtes

Une requête pour les routes les plus proches doit être envoyée via HTTPS et prend la forme suivante :

https://roads.googleapis.com/v1/nearestRoads?parameters&key=YOUR_API_KEY

Utilisation des paramètres

Paramètres obligatoires

  • points — Liste de paires latitude/longitude. Les valeurs de latitude et de longitude doivent être séparées par des virgules. Les coordonnées doivent être séparées par une barre verticale : « | ». Par exemple: points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
  • key — Clé d'API de votre application. Votre application doit s'identifier à chaque fois qu'elle envoie une requête à Google Maps Roads API, en incluant une clé d'API avec chaque requête. Découvrez comment obtenir une clé.

Réponses

Pour chaque requête valide, Google Maps Roads API renvoie une réponse au format indiqué dans l'URL de la requête. Les éléments suivants peuvent être présents dans une réponse Snap to Roads.

  • snappedPoints — Tableau des points balisés. Chaque point est composé des champs suivants :
    • location — Contient une valeur latitude et une valeur longitude.
    • originalIndex — Nombre entier indiquant la valeur correspondante dans la requête initiale. Chaque point dans la requête correspond au maximum à deux segments dans la réponse :
      • S'il n'y a aucune route à proximité, aucun segment n'est renvoyé.
      • Si la route la plus proche est à sens unique, un seul segment est renvoyé.
      • Si la route la plus proche est à double sens, deux segments sont renvoyés.
    • placeId — Identifiant unique d'un lieu. Tous les identifiants de lieu renvoyés par Google Maps Roads API correspondent à des segments de route. [Les identifiants de lieu] peuvent être utilisés avec d'autres API Google, notamment Google Places API et Google Maps JavaScript API. Par exemple, si vous avez besoin du nom des routes pour les points balisés renvoyés par Google Maps Roads API, vous pouvez transmettre l'objet placeId à Google Places API ou Google Maps Geocoding API. Dans Google Maps Roads API, vous pouvez transmettre l'objet placeId à une requête de limites de vitesse pour déterminer la limitation de vitesse le long de ce segment de route.

Exemple de requête

La requête suivante renvoie un ensemble de segments de route basé sur une liste donnée de coordonnées.

Requête

https://roads.googleapis.com/v1/nearestRoads?points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796&key=YOUR_API_KEY

Réponse

{
  "snappedPoints": [
    {
      "location": {
        "latitude": 60.170877918672588,
        "longitude": 24.942699821922421
      },
      "originalIndex": 0,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170876898776406,
        "longitude": 24.942699912064771
      },
      "originalIndex": 1,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170874902634374,
        "longitude": 24.942700088491474
      },
      "originalIndex": 2,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    }
  ]
}

Envoyer des commentaires concernant…

Google Maps Roads API
Google Maps Roads API
Besoin d'aide ? Consultez notre page d'assistance.