Strade più vicine

L'API Roads API accetta fino a 100 coordinate indipendenti e restituisce il segmento di strada più vicino per ogni punto. I punti passati non devono far parte di un percorso continuo.

Se utilizzi punti GPS sequenziali, utilizza posizionamento su strada.

Richieste

Una richiesta di strade più vicine deve essere inviata utilizzando HTTPS e ha il seguente formato:

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

Parametri obbligatori

punti

I punti da agganciare. Il parametro points accetta un elenco di coppie di latitudine/longitudine. Separa i valori di latitudine e longitudine con le virgole. Separa le coordinate con il carattere barra verticale: "|". Ad esempio: points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.

Esempi

La seguente richiesta restituisce un insieme di segmenti stradali in base all'elenco di coordinate specificato.

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'

Risposte

Per ogni richiesta valida, Roads API restituirà una risposta nel formato indicato nell'URL della richiesta.

{
  "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 risposta utilizza lo schema seguente.

NearestRoadsResponse

Campo	Obbligatorio	Tipo	Descrizione
snappedPoints	facoltativo	Array<SnappedPoint>	Un array di punti agganciati. A volte contiene più punti agganciati per lo stesso punto con placeId o posizione diversi. Per saperne di più, consulta SnappedPoint.

SnappedPoint

Campo	Obbligatorio	Tipo	Descrizione
location	required	LatitudeLongitudeLiteral	Per saperne di più, consulta LatitudeLongitudeLiteral.
placeId	required	stringa	Un identificatore univoco di un luogo. Tutti gli ID luogo restituiti dall'API Roads corrispondono a segmenti stradali.
originalIndex	facoltativo	numero	Un numero intero che indica il valore corrispondente nella richiesta originale. Ogni valore nella richiesta deve essere mappato a un valore agganciato nella risposta. Tuttavia, se hai impostato interpolate=true o se utilizzi le strade più vicine, è possibile che la risposta contenga più coordinate rispetto alla richiesta. I valori interpolati non avranno un originalIndex. Questi valori sono indicizzati a partire da 0, quindi un punto con un originalIndex di 4 sarà il valore agganciato della quinta latitudine/longitudine passata al parametro di percorso. I punti di Nearest Roads possono contenere più punti per singole coordinate con località o placeId diversi.

LatitudeLongitudeLiteral

Un oggetto che descrive una località specifica con latitudine e longitudine in gradi decimali.

Campo	Obbligatorio	Tipo	Descrizione
latitude	required	numero	Latitudine in gradi decimali
longitude	required	numero	Longitudine in gradi decimali