Strade più vicine

The Roads API takes up to 100 independent coordinates, and returns the closest road segment for each point. I punti passati non devono far parte di un percorso continuo.

Se utilizzi punti GPS sequenziali, usa posizionamento su strada.

Richieste

Una richiesta di 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 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, 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 posizione diversi.

Per ulteriori informazioni, vedi SnappedPoint.

SnappedPoint

Campo Obbligatorio Tipo Descrizione
elemento obbligatorio LatitudeLongitudeLiteral Per ulteriori informazioni, vedi LatitudeLongitudeLiteral.
elemento 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 da 0, quindi un punto con un originalIndex di 4 sarà il valore allineato della quinta latitudine/longitudine passata al parametro di percorso. I punti delle strade più vicine possono contenere diversi 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
elemento obbligatorio numero

Latitudine in gradi decimali
elemento obbligatorio numero

Longitudine in gradi decimali