Kartenkacheln sind eine Unterteilung einer Welt in ein indexiertes Raster. Damit können Sie in verschiedenen kartografischen Maßstäben effizient und dynamisch auf Kartendaten zugreifen und diese nutzen. Mit der Map Tiles API erhalten Sie Zugriff auf mehrere thematische Geodatasets, unter anderem von Google ausgewählte:
Roadmap-Bildkacheln basierend auf topografischen Vektordaten mit dem kartografischen Stil von Google.
Orthopfotografie, die sowohl von Satelliten- als auch von Luftkameras aufgenommen wurde, die von oben nach unten (Nadir) Bilder der Erde liefern.
Höhenschattenkarten.
2D-Kartenkacheln sind alle mit Georeferenzen versehen und aneinander ausgerichtet. Sie werden basierend auf der geografischen Ausdehnung des Darstellungsbereichs und der Zoomstufe ausgewählt. Die Zoomstufen reichen von 0 (für die vollständige Darstellung der Welt) bis 22 (für die Anzeige 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 natürlichen Gegebenheiten wie der Vegetation |
Wenn Sie Kartenkacheln von der Map Tiles API anfordern möchten, müssen Sie zuerst ein Sitzungstoken anfordern. Mit dem Sitzungstoken wird der aktuelle Status der Karte und des Darstellungsbereichs erfasst. Wenn Sie das Sitzungstoken einrichten, müssen Sie den Wert mapType so festlegen, dass er dem gewünschten Kartendesign entspricht.
Anschließend müssen Sie das Sitzungstoken in jede Ihrer Anfragen an die Map Tiles API angeben.
Anfragen für Informationen zum Darstellungsbereich
Der Darstellungsbereich definiert die Größe des Rechtecks, das die Weltszene umrahmt. Anfragen für Darstellungsbereichsinformationen geben Details zu den Kartenkacheln zurück, aus denen der aktuelle Darstellungsbereich besteht. Sie fordern Informationen zum Darstellungsbereich an, damit keine Bilder mit Zoomstufen angefordert werden, die nicht vorhanden sind.
Die meisten Städte haben beispielsweise Bilder mit Zoomstufe 22, aber nicht das Meer, da am Ende nur funktionslose blaue Quadrate angezeigt würden.
Die Viewport-Anfrage ist eine HTTPS-GET-Anfrage mit der folgenden Form.
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- Der am weitesten entfernte Nord-, Süd-, Ost- und Westpunkt 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 180. Längengrad kreuzen, kann Westen positiv (z. B. 170) und Osten negativ sein (z. B. -170). Alle Parameter sind erforderlich.
Antworten für Informationen zum Darstellungsbereich
Die Darstellung des Darstellungsbereichs gibt an, für welche Bereiche Bilder vorhanden sind und mit welchen Zoomstufen. Eine Antwort zur Darstellung von Informationen zum Darstellungsbereich hat das folgende Format.
{
"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, den Sie auf Ihrer Karte anzeigen müssen, wenn Sie Straßenkarten- und Satellitenkacheln anzeigen lassen. Weitere Informationen findest du in den Map Tiles API-Richtlinien.
maxZoomRect- Enthält ein Array von Begrenzungsrahmen, die sich mit dem aktuellen Darstellungsbereich überschneiden. Enthält auch die maximale Zoomstufe, die in jedem Rechteck verfügbar ist.
Kachelkoordinatenfunktionen
In den meisten Programmiersprachen stehen Tools (einfache Funktionen) zur Verfügung, mit denen Sie Breiten- und Längengradpaare in Kachelkoordinaten bei einem bestimmten Zoomfaktor konvertieren können.
Im folgenden JavaScript-Codebeispiel werden zuerst latLng in einen Punkt und dann 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
};
}