Strade più vicine

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

Se utilizzi punti GPS sequenziali, usa posizionamento su strada.

Richieste

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

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

Parametri obbligatori

  • punti

    I punti da allineare. 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 di strada 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, il 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 allineati. A volte contiene diversi punti allineati per lo stesso punto con placeId o località diversi.

Per ulteriori informazioni, consulta SnappedPoint.

SnappedPoint

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

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

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 da 0, quindi un punto con un originalIndex di 4 sarà il valore allineato della quinta latitudine/longitudine passata al parametro path. I punti delle strade più vicine 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
elemento obbligatorio numero

Latitudine in gradi decimali
elemento obbligatorio numero

Longitudine in gradi decimali