I 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 riquadri della roadmap
Puoi iniziare a effettuare richieste di riquadro della roadmap dopo aver ottenuto 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 illustra una tipica richiesta di token di sessione per i riquadri di mappe stradali.
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 ottenere riquadri della roadmap effettuando una richiesta GET HTTPS, 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) e x e
y sono le coordinate dei riquadri
del riquadro che vuoi recuperare.
Il parametro orientation è facoltativo. Il suo valore specifica il numero di gradi di rotazione antioraria dell'immagine riquadro. orientation è
supportato per i riquadri roadmap, oltre che per le richieste satellitari 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 |
|---|---|
 |
 |
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 è 0, mentre 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, consulta Pre-recupero, memorizzazione nella cache o archiviazione dei contenuti.