Strade più vicine

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

Se lavori con punti GPS sequenziali, utilizza Snap to Roads.

Richieste

Una richiesta alle strade più vicine deve essere inviata utilizzando HTTPS e assume la seguente forma:

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

Parametri obbligatori

  • punti

    I punti da allineare. Il parametro punti accetta un elenco di coppie di latitudine/longitudine. Separa i valori di latitudine e longitudine con le virgole. Separa le coordinate con il carattere della 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 specificato di coordinate.

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
facoltativo Array<SnappedPoint>

Un array di punti agganciati. A volte contiene diversi punti agganciati per lo stesso punto con ID luogo o posizione diversi.

Per saperne di più, consulta SnappedPoint.

SnappedPoint

Campo Obbligatorio Tipo Descrizione
obbligatorio LatitudeLongitudeLiteral Per ulteriori informazioni, consulta LatitudeLongitudeLiteral.
obbligatorio stringa

Un identificatore univoco per un luogo. Tutti gli ID luogo restituiti dall'API Roads corrispondono a segmenti stradali.

facoltativo numero

Un numero intero che indica il valore corrispondente nella richiesta originale. Ogni valore nella richiesta deve essere mappato a un valore allineato nella risposta. Tuttavia, se hai impostato interpolate=true o se utilizzi le strade più vicine, è possibile che la risposta contenga più coordinate della 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 percorso. I punti Strade più vicine possono contenere più punti per singole coordinate con posizione o placeId diversi.

LatitudeLongitudeLiteral

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

Campo Obbligatorio Tipo Descrizione
obbligatorio numero

Latitudine in gradi decimali
obbligatorio numero

Longitudine in gradi decimali