Kartenkacheln sind einfach die Unterteilung der Welt in ein indexiertes Raster. Damit können Sie in unterschiedlichen kartografischen Größenordnungen effizient und dynamisch auf Kartendaten zugreifen und diese nutzen. Mit der Map Tiles API erhalten Sie Zugriff auf mehrere thematische Geo-Datasets, darunter von Google zusammengestellte:
Roadmap-Bildkacheln basierend auf topografischen Vektordaten mit den kartografischen Stilen von Google erstellen
Orthophotografie, die sowohl von Satelliten- als auch von Luftkameras aufgenommen wurde und Draufsicht (Nadir) der Erde liefert.
Konturkarten für Hillshade.
2D-Kartenkacheln sind alle georeferenziert und aneinander ausgerichtet. Sie werden basierend auf der geografischen Größe des Darstellungsbereichs und der Zoomstufe ausgewählt. Die Zoomstufen reichen von null (um die ganze Welt zu sehen) bis 22 (zur Darstellung von Straßen und Blöcken).
Kartendesigns
Sie können Kartenkacheln für die folgenden Kartendesigns abrufen.
| Kartendesign | Beschreibung |
|---|---|
| Roadmap | Straßen, Gebäude, POIs und politische Grenzen |
| Satellit | Fotografische Bilder aus dem Weltraum |
| Gelände | Eine Konturkarte mit Landschaftsmerkmalen wie z. B. Vegetation |
Um Kartenkacheln über die Map Tiles API anzufordern, müssen Sie zuerst ein Sitzungstoken anfordern. Mit dem Sitzungstoken wird der aktuelle Status Ihrer Karte und des Darstellungsbereichs erfasst. Beim Einrichten des Sitzungstokens müssen Sie den Wert mapType so festlegen, dass er dem gewünschten Kartenthema entspricht.
Anschließend müssen Sie das Sitzungstoken in jede Anfrage an die Map Tiles API aufnehmen.
Anfragen nach Informationen zum Darstellungsbereich
Der Darstellungsbereich definiert die Größe der Box, die die Weltszene umrahmt. Bei Anfragen zu Darstellungsbereichsinformationen werden Details zu den Kartenkacheln zurückgegeben, aus denen der aktuelle Darstellungsbereich besteht. Sie fordern Informationen zum Darstellungsbereich an, damit keine Bilder in Zoomstufen angefordert werden, die es nicht gibt.
In den meisten Städten sind beispielsweise Bilder in Zoomstufe 22 vorhanden, aber nicht der Ozean, da dort am Ende gar keine blauen Quadrate zu sehen wären.
Die Darstellungsbereich-Anfrage ist eine HTTPS-GET-Anfrage im folgenden Format.
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"
Die Anfrage enthält die folgenden Felder:
zoom- Die Zoomstufe des Darstellungsbereichs.
north,south,east,west- Die am weitesten entfernten Nord-, Süd-, Ost- und Westpunkte im Darstellungsbereich, ausgedrückt in Grad. Norden und Süden müssen im Bereich (-90,90) liegen, Osten und Westen müssen im Bereich (-180, 180) liegen. Um Grenzen auszudrücken, die den 170-Längengrad überschreiten, kann Westen positiv (z. B. 170) und Osten negativ (z. B. -170) sein. Alle Parameter sind erforderlich.
Antworten zu Informationen zum Darstellungsbereich
Die Antwort für den Darstellungsbereich gibt an, für welche Bereiche Bilder verfügbar sind und in welchen Zoomstufen. Die Antwort auf Informationen zum Darstellungsbereich sieht so aus:
{
"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
}, ...
]
}
Der Antworttext enthält die folgenden Felder.
copyright- Enthält einen Attributionsstring, der auf der Karte angezeigt werden muss, wenn Sie Straßen- und Satellitenkacheln einblenden. Weitere Informationen finden Sie in den Richtlinien für die Map Tiles API.
maxZoomRect- Enthält ein Array von Begrenzungsrechtecken, die sich mit dem aktuellen Darstellungsbereich überlappen. Enthält auch die maximale Zoomstufe, die in den einzelnen Rechtecken verfügbar ist.
Kachelkoordinatenfunktionen
In den meisten Programmiersprachen sind Tools (einfache Funktionen) verfügbar, um Breiten- und Längengradpaare in Kachelkoordinaten bei einer bestimmten Zoomstufe umzuwandeln.
Im folgenden JavaScript-Codebeispiel wird zuerst ein latLng-Wert in einen Punkt und dann von einem Punkt zu Kachelkoordinaten konvertiert.
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
};
}