I riquadri della mappa non sono altro che la divisione del mondo in un
a griglia. Puoi accedere ai dati delle mappe e utilizzarli in modo efficiente e dinamico
su più scale cartografiche. L'API Map Tiles ti dà accesso a
più set di dati geografici tematici, tra cui:
Riquadri di immagini della roadmap basati su dati topografici vettoriali con stili cartografici.
Ortofotografia acquisita da fotocamere satellitari e aeree che offrono immagini della Terra dall'alto verso il basso (nadir).
Mappe dei contorni di Hillshade.
I riquadri della mappa 2D sono tutti georeferenziati e allineati tra loro. Vengono selezionati in base all'estensione geografica dell'area visibile e al livello di zoom. Livelli di zoom un intervallo da zero (per vedere il mondo nella sua interezza) a 22 (per visualizzare strade e isolati).
Temi della mappa
Puoi ottenere riquadri della mappa per i seguenti temi della mappa.
Tema mappa | Descrizione |
---|---|
Roadmap | Strade, edifici, punti d'interesse e confini politici |
Satellite | Immagini fotografiche scattate dallo spazio |
Rilievo | Una mappa di contorno che mostra elementi naturali come la vegetazione |
Per richiedere riquadri della mappa dall'API Map Tiles, devi prima richiedere un
token di sessione. Il token di sessione
tiene traccia dello stato corrente della mappa e dell'area visibile. Quando configuri la sessione
devi impostare il valore mapType
in modo che corrisponda al tema della mappa che preferisci.
Quindi, devi includere il token di sessione in ogni richiesta di
API Map Tiles.
Richieste di informazioni sull'area visibile
L'area visibile definisce le dimensioni del riquadro che incornicia la scena del mondo. Area visibile le richieste di informazioni restituiscono dettagli sui riquadri della mappa che compongono il tuo area visibile corrente. Il motivo per cui richiedi informazioni sull'area visibile serve evitare di richiedere immagini a livelli di zoom inesistenti.
Ad esempio, per la maggior parte delle città sono disponibili immagini a livello di zoom 22, ma non l'oceano, finirebbe per mostrare quadrati blu senza caratteristiche.
La richiesta di area visibile è una richiesta GET HTTPS nel formato seguente.
curl "https://tile.googleapis.com/tile/v1/viewport?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &zoom=zoom &north=north &south=south &east=east &west=west"
La richiesta contiene i seguenti campi:
zoom
- Il livello di zoom dell'area visibile.
north
,south
,east
ewest
- I punti più a nord, sud, est e ovest nell'area visibile, espressi in gradi. Nord e sud devono essere compresi nell'intervallo (-90,90), est e ovest devono essere compresi l'intervallo (-180, 180). Per esprimere i confini che superano l'antimeridiano, ovest può essere positivo (ad es. 170) mentre est può essere negativo (ad es. -170). Tutti sono obbligatori.
Risposte relative alle informazioni sull'area visibile
La risposta dell'area visibile indica per quali aree sono presenti immagini e a quale zoom diversi. Una risposta alle informazioni sull'area visibile ha il seguente modulo.
{
"copyright": "Map data ©2023",
"maxZoomRects": [
{
"maxZoom": 19,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
{
"maxZoom": 9,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
{
"maxZoom": 14,
"north": 84.375,
"south": -84.375,
"east": 180,
"west": -180
}, ...
]
}
Il corpo della risposta contiene i seguenti campi.
copyright
- Contiene una stringa di attribuzione che devi visualizzare sulla mappa quando visualizzare riquadri di roadmap e satelliti. Per ulteriori informazioni, consulta Norme dell'API Map Tiles.
maxZoomRect
- Contiene un array di rettangoli di delimitazione che si sovrappongono al area visibile. Contiene anche il livello di zoom massimo disponibile all'interno di ogni rettangolo.
Funzioni coordinate dei riquadri
Strumenti (funzioni semplici) sono disponibili nella maggior parte dei linguaggi di programmazione per la conversione
dalle coppie latitudine/longitudine alle coordinate dei riquadri a un livello di zoom specifico.
Considera il seguente esempio di codice JavaScript che esegue per prima cosa una conversione da un
latLng
a un punto e poi da un punto a un riquadro.
var TILE_SIZE = 256;
function fromLatLngToPoint(latLng) {
var mercator = -Math.log(Math.tan((0.25 + latLng.lat() / 360) * Math.PI));
return {
x: TILE_SIZE * (latLng.lng() / 360 + 0.5),
y: TILE_SIZE / 2 * (1 + mercator / Math.PI)
};
}
function fromLatLngToTileCoord(latLng, zoom) {
var point = fromLatLngToPoint(latLng);
var scale = Math.pow(2, zoom);
return {
x: Math.floor(point.x * scale / TILE_SIZE),
y: Math.floor(point.y * scale / TILE_SIZE),
z: zoom
};
}