Riquadri della roadmap

I riquadri della roadmap sono riquadri immagine basati su dati topografici vettoriali con lo stile cartografico di Google. Sono inclusi strade, edifici, punti d'interesse e confini politici.

Recupero delle schede della roadmap

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 devi specificare le opzioni della mappa con le richieste di riquadro.

Il seguente esempio di codice mostra 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"

Per ottenere i riquadri della roadmap, effettua una richiesta HTTPS GET, come mostrato nell'esempio seguente.

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 GET HTTPS, z è il livello di zoom (compreso tra 0 e 22), mentre x e y sono le coordinate del riquadro del riquadro che vuoi recuperare.

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

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

Orientamento a zero gradi	Orientamento a 90 gradi

Esempio di richiesta di riquadro

Considera l'esempio seguente, che richiede un singolo riquadro contenente il mondo intero. In questo esempio, il livello di zoom è 0 e le coordinate x e y sono 0, 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 scaricato in un file locale con le seguenti statistiche.

  % 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, vedi Pre-fetching, memorizzazione nella cache o archiviazione dei contenuti.