Routes les plus proches

Roads API accepte jusqu'à 100 coordonnées indépendantes et renvoie le segment de route le plus proche pour chaque point. Les points transmis n'ont pas besoin de faire partie d'un chemin continu.

Si vous utilisez des points GPS séquentiels, utilisez Aligner sur les routes.

Requêtes

Une requête envoyée au service Nearest Roads doit utiliser le protocole HTTPS et se présente sous la forme suivante :

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

Paramètres obligatoires

points

Points à aligner. Le paramètre "points" accepte une liste de paires latitude/longitude. Séparez les valeurs de latitude et de longitude par une virgule. Séparez les coordonnées par une barre verticale : "|". Par exemple : points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.

Exemples

La requête suivante renvoie un ensemble de segments de route en fonction de la liste de coordonnées spécifiée.

URL

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://roads.googleapis.com/v1/nearestRoads?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796&key=YOUR_API_KEY'

Réponses

Pour chaque requête valide, Roads API renvoie une réponse au format indiqué dans l'URL de la requête.

{
  "snappedPoints":
    [
      {
        "location":
          { "latitude": 60.170878428876755, "longitude": 24.94269540970182 },
        "originalIndex": 0,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.17087741412199, "longitude": 24.942695474405202 },
        "originalIndex": 1,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.170875416131736, "longitude": 24.942695601802203 },
        "originalIndex": 2,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
    ],
}

La réponse utilise le schéma suivant.

NearestRoadsResponse

Champ Obligatoire Type Description
facultatif Tableau<SnappedPoint>

Tableau de points d'ancrage. Contient parfois plusieurs points d'ancrage pour le même point avec un ID de lieu ou un emplacement différent.

Pour en savoir plus, consultez SnappedPoint.

SnappedPoint

Champ Obligatoire Type Description
required LatitudeLongitudeLiteral Pour en savoir plus, consultez LatitudeLongitudeLiteral.
required chaîne

Identifiant unique d'un lieu. Tous les ID de lieu renvoyés par l'API Roads correspondent à des segments de route.

facultatif nombre

Entier indiquant la valeur correspondante dans la requête d'origine. Chaque valeur de la requête doit correspondre à une valeur de la réponse. Toutefois, si vous avez défini interpolate=true ou si vous utilisez les routes les plus proches, il est possible que la réponse contienne plus de coordonnées que la requête. Les valeurs interpolées n'auront pas de originalIndex. Ces valeurs sont indexées à partir de 0. Ainsi, un point avec un originalIndex de 4 sera la valeur de l'alignement de la cinquième latitude/longitude transmise au paramètre de chemin d'accès. Les points Nearest Roads peuvent contenir plusieurs points pour des coordonnées uniques avec un emplacement ou un placeId différent.

LatitudeLongitudeLiteral

Objet décrivant un emplacement spécifique avec la latitude et la longitude en degrés décimaux.

Champ Obligatoire Type Description
required nombre

Latitude en degrés décimaux
required nombre

Longitude en degrés décimaux