Riquadri della roadmap

Panoramica dei riquadri della roadmapI riquadri della mappa stradale sono riquadri di immagini basati su dati topografici vettoriali con lo stile cartografico di Google. Sono inclusi strade, edifici, punti d'interesse e confini politici.

Recupero dei riquadri della roadmap in corso...

Puoi iniziare a effettuare richieste di riquadri della roadmap dopo aver ricevuto un token di sessione. Poiché il token di sessione si applica all'intera sessione, non è necessario specificare le opzioni di mappa con le richieste di riquadri.

Il seguente esempio di codice dimostra una tipica richiesta di token di sessione per i riquadri della roadmap.

curl -X POST -d '{
  "mapType": "roadmap",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

Puoi visualizzare i riquadri della roadmap effettuando una richiesta HTTPS GET, come mostrato nell'esempio che segue.

curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&orientation=0_or_90_or_180_or_270"

In questa richiesta HTTPS GET, z è il livello di zoom (da 0 a 22), mentre x e y sono le coordinate del riquadro che vuoi recuperare.

Il parametro orientation è facoltativo. Il suo valore specifica il numero di gradi di rotazione antiorario dell'immagine riquadro. orientation è supportato per i riquadri roadmap ed è supportato anche per le richieste satellite e rilievo con immagini di base rimosse utilizzando "overlay": true e con layerTypes impostato. I valori orientation validi sono 0 (valore predefinito), 90, 180 e 270.

La griglia delle coordinate dei riquadri non viene ruotata se includi un valore orientation. Ad esempio, se imposti orientation su 90, la coordinata x definisce comunque la posizione da sinistra a destra del riquadro, che in questo caso va da nord a sud sulla mappa.

Orientamento zero gradi Orientamento a 90 gradi
Orientamento zero gradi Orientamento a 90 gradi

Esempio di richiesta di riquadro

Considera l'esempio seguente, che richiede un singolo riquadro che contiene il mondo intero. In questo esempio, il livello di zoom è pari a 0 e le coordinate x e y sono 0 e 0.

curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png

In questo esempio non è presente alcun messaggio di risposta dal server. Il riquadro viene invece scaricato in un file locale con le seguenti statistiche.

Il mondo intero in un unico riquadro

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  8335  100  8335    0     0  51471      0 --:--:-- --:--:-- --:--:-- 54835

Per informazioni sulle intestazioni dei messaggi di risposta, consulta Pre-recupero, memorizzazione nella cache o archiviazione dei contenuti.