I riquadri della mappa stradale sono riquadri di immagini basati su dati topografici vettoriali con gli stili cartografici di Google. Sono inclusi strade, edifici, punti di interesse e confini politici.
Ottenere riquadri della roadmap
Puoi iniziare a inviare richieste di riquadri della roadmap dopo aver ottenuto un token sessione. Poiché il token di sessione si applica all'intera sessione, non devi specificare le opzioni della mappa con le richieste dei riquadri.
Il seguente esempio di codice mostra una richiesta di token di sessione tipica 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 ottenere i riquadri della roadmap inviando 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 (da 0 a 22) e x e y sono le coordinate del tile del tile che vuoi recuperare.
Il parametro orientation è facoltativo. Il relativo valore specifica il numero di gradi di rotazione antioraria dell'immagine del riquadro. orientation è supportato per i riquadri roadmap e anche per le richieste di immagini 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 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 a zero gradi | Orientamento a 90 gradi |
|---|---|
 |
 |
Richiesta di riquadro di esempio
Considera l'esempio seguente, che richiede un singolo riquadro contenente l'intero mondo. 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 del server. Il riquadro viene invece 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-fetching, memorizzazione nella cache o archiviazione dei contenuti.