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

Speed Limits

Remarque : Le service Speed Limits est uniquement disponible pour les clients Google Maps APIs Premium Plan avec licence de suivi des ressources.

Google Maps Roads API renvoie les limites de vitesse indiquées pour un segment de route donné. Dans le cas de segments de route avec des limites de vitesse variables, la limite de vitesse par défaut du segment est renvoyée.

L'exactitude des données de limite de vitesse renvoyées par Google Maps Roads API ne peut pas être garantie. Les données de limite de vitesse fournies ne sont pas en temps réel et peuvent être approximatives, inexactes, incomplètes et/ou obsolètes. Il est possible de signaler des inexactitudes dans nos données via le service Google Map Maker.

Requêtes

Une requête de limites de vitesse doit être envoyée via HTTPS et prend la forme suivante :

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

Utilisation des paramètres

Paramètres obligatoires

  • Soit un path, soit un ou plusieurs placeId.
    • path — Tracé à baliser. Le paramètre path accepte une 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 : path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
    • placeId— Identifiant de lieu du segment de route. Des identifiants de lieu sont renvoyés en réponse aux requêtes snapToRoads et nearestRoads. Vous pouvez transmettre jusqu'à 100 éléments placeId avec chaque requête.
  • 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é.

Paramètres facultatifs

  • units — Détermine si les limites de vitesse doivent être renvoyées en kilomètres ou en miles par heure. Peut être défini sur KPH ou MPH. La valeur par défaut est KPH.

Vous pouvez demander des données de limite de vitesse avec path ou une série d'identifiants de lieu placeId ; cependant, vous ne recevrez qu'une seule réponse pour chaque placeId unique dans la requête. Des doublons d'identifiants de lieu placeId peuvent être présents lorsqu'il y a de nombreux points sur une courte distance.

Réponses

Les éléments suivants peuvent être présents dans une réponse speedLimits :

  • speedLimits — Tableau des métadonnées de route. Chaque élément est composé des champs suivants :
    • placeId — Identifiant unique d'un lieu. Tous les identifiants de lieu placeId renvoyés par Google Maps Roads API correspondent à des segments de route.
    • speedLimit — Limite de vitesse pour ce segment de route.
    • units — Renvoie KPH ou MPH.
  • snappedPoints — Tableau des points balisés. Ce tableau est uniquement présent si la requête contenait un paramètre path. 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 valeur dans la requête doit correspondre à une valeur balisée dans la réponse. Ces valeurs sont indexées à partir de 0, pour qu'un point dont le paramètre originalIndex est défini sur 4 corresponde à la valeur balisée de la 5ème latitude/longitude transmise au paramètre path.
    • placeId — Identifiant unique d'un lieu. Tous les identifiants de lieu placeId renvoyés par Google Maps Roads API correspondent à des segments de route. L'identifiant de lieu placeId peut être transmis à 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 détermine les limites de vitesse sur un court tronçon de route à Canberra, en Australie.

Requête

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJ1Wi6I2pNFmsRQL9GbW7qABM
        &placeId=ChIJ58xCoGlNFmsRUEZUbW7qABM
        &placeId=ChIJ9RhaiGlNFmsR0IxAbW7qABM
        &placeId=ChIJabjuhGlNFmsREIxAbW7qABM
        &placeId=ChIJcSAlFWpNFmsRMHlUbW7qABM
        &placeId=ChIJI2FUTGhNFmsRcHpAbW7qABM
        &placeId=ChIJiy6YT2hNFmsRkHZAbW7qABM
        &placeId=ChIJoR7CemhNFmsRQB9QbW7qABM
        &placeId=ChIJP2m_FWpNFmsRIHlUbW7qABM
        &placeId=ChIJtV7La2pNFmsRAGpHbW7qABM
        &placeId=ChIJW5JAZmpNFmsRegG0-Jc80sM
        &placeId=ChIJW9R7smlNFmsRMH1AbW7qABM
        &placeId=ChIJy8c0r2lNFmsRQEZUbW7qABM
        &key=YOUR_API_KEY

Réponse

{
  "speedLimits": [
    {
      "placeId": "ChIJ1Wi6I2pNFmsRQL9GbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ58xCoGlNFmsRUEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ9RhaiGlNFmsR0IxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJabjuhGlNFmsREIxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJcSAlFWpNFmsRMHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJI2FUTGhNFmsRcHpAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJiy6YT2hNFmsRkHZAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJoR7CemhNFmsRQB9QbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJP2m_FWpNFmsRIHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJtV7La2pNFmsRAGpHbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW5JAZmpNFmsRegG0-Jc80sM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW9R7smlNFmsRMH1AbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJy8c0r2lNFmsRQEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    }
  ]
}

Envoyer des commentaires concernant…

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