Panoramica dei riquadri 2D

I riquadri della mappa sono semplicemente la divisione del mondo in una griglia indicizzata. Ti consente di accedere ai dati della mappa e di utilizzarli in modo efficiente e dinamico su più scale cartografiche. L'API Map Tiles ti consente di accedere a più set di dati geografici tematici, tra cui quelli selezionati da Google:

• Immagini di mappe stradali basate su dati topografici vettoriali con lo stile cartografico di Google.

• Ortofotografia acquisita da fotocamere satellitari e aeree che forniscono immagini della Terra dall'alto verso il basso (nadir).

• Mappe delle curve di livello con rilievo ombreggiato.

I riquadri delle mappe 2D sono tutti georeferenziati e allineati tra loro. Vengono selezionati in base all'estensione geografica dell'area visibile e al livello di zoom. I livelli di zoom vanno da zero (per visualizzare il mondo nella sua interezza) a 22 (per visualizzare strade e isolati).

Temi delle mappe

Puoi ottenere i riquadri della mappa per i seguenti temi.

Per richiedere i riquadri di mappa dall'API Map Tiles, devi prima richiedere un token di sessione. Il token di sessione monitora lo stato attuale della mappa e dell'area visibile. Quando configuri il token di sessione, devi impostare il valore mapType in modo che corrisponda al tema della mappa che preferisci. In seguito, devi includere il token di sessione in ogni richiesta all'API Map Tiles.

Richieste di informazioni sull'area visibile

La finestra visibile definisce le dimensioni della casella che inquadra la scena del mondo. Le richieste di informazioni sull'area visibile restituiscono dettagli sui riquadri della mappa che compongono l'area visibile corrente. Il motivo per cui richiedi le informazioni sull'area visibile è assicurarti di evitare di richiedere immagini a livelli di zoom inesistenti.

Ad esempio, la maggior parte delle città ha immagini al livello di zoom 22, ma non l'oceano, poiché finirebbe per mostrare solo quadrati blu senza elementi.

La richiesta di viewport è una richiesta GET HTTPS nel seguente formato.

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, west

I punti più a nord, sud, est e ovest nell'area visibile, espressi in gradi. I valori di nord e sud devono essere compresi nell'intervallo (-90,90), mentre quelli di est e ovest devono essere compresi nell'intervallo (-180, 180). Per esprimere i limiti che attraversano l'antimeridiano, west può essere positivo (ad esempio 170) ed east può essere negativo (ad esempio -170). Tutti i parametri sono obbligatori.

Risposte con informazioni sull'area visibile

La risposta della finestra visiva indica quali aree contengono immagini e a quali livelli di zoom. Una risposta con informazioni sull'area visibile ha il seguente formato.

{
  "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 mostrare sulla mappa quando mostri i riquadri della mappa stradale e satellitari. Per saperne di più, consulta le policy dell'API Map Tiles.

maxZoomRect

Contiene un array di rettangoli di delimitazione che si sovrappongono all'area visibile corrente. Contiene anche il livello di zoom massimo disponibile all'interno di ogni rettangolo.

Funzioni delle coordinate dei riquadri

Gli strumenti (funzioni semplici) sono disponibili nella maggior parte dei linguaggi di programmazione per convertire le coppie di latitudine/longitudine in coordinate dei riquadri a un livello di zoom specifico. Considera il seguente esempio di codice JavaScript che converte prima da un latLng a un punto e poi da un punto alle coordinate dei riquadri.

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
  };
}