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.