Karten-Tiles sind einfach die Aufteilung der Welt in ein indexiertes Raster. Sie können damit effizient und dynamisch auf Kartendaten in verschiedenen kartografischen Maßstäben zugreifen und sie nutzen. Mit der Map Tiles API erhalten Sie Zugriff auf mehrere thematische Geodatensätze, darunter von Google zusammengestellte:
Straßenkarten-Bildkacheln basierend auf topografischen Vektordaten mit dem kartografischen Stil von Google.
Orthofotografie, die sowohl von Satelliten- als auch von Luftbildkameras aufgenommen wird und Nadir-Bilder der Erde liefert.
Höhenlinienkarten mit Schummerung.
Alle 2D Map Tiles sind georeferenziert und aufeinander abgestimmt. Sie werden anhand der geografischen Ausdehnung des Darstellungsbereichs und der Zoomstufe ausgewählt. Die Zoomstufen reichen von 0 (die ganze Welt) bis 22 (Straßen und Häuserblocks).
Kartendesigns
Sie können Karten-Tiles für die folgenden Kartendesigns abrufen.
| Kartendesign | Beschreibung |
|---|---|
| Roadmap | Straßen, Gebäude, Points of Interest (POIs) und politische Grenzen |
| Satellit | Fotografische Bilder aus dem Weltraum |
| Gelände | Eine Höhenlinienkarte, die natürliche Merkmale wie Vegetation zeigt |
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 Ihr 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 Anfrage an die Map Tiles API einfügen.
Anfragen nach Informationen zum Darstellungsbereich
Der Darstellungsbereich definiert die Größe des Felds, das die Weltansicht umrahmt. Anfragen zu Darstellungsbereichsinformationen geben Details zu den Karten-Tiles zurück, aus denen der aktuelle Darstellungsbereich besteht. Sie fordern Informationen zum Darstellungsbereich an, um zu vermeiden, dass Bilder mit nicht vorhandenen Zoomstufen angefordert werden.
Für die meisten Städte sind beispielsweise Bilder mit der Zoomstufe 22 verfügbar, für den Ozean jedoch nicht, da dort nur blaue Quadrate ohne Merkmale angezeigt würden.
Die Darstellungsbereichsanfrage 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 nördlichsten, südlichsten, östlichsten und westlichsten Punkte im Darstellungsbereich, angegeben in Grad. Der Norden und der Süden müssen im Bereich (-90,90) liegen, der Osten und der Westen im Bereich (-180, 180). Wenn die Grenzen den Antimeridian überschreiten, kann der Wert für „west“ positiv (z. B. 170) und der Wert für „east“ negativ (z. B. -170) sein. Alle Parameter sind erforderlich.
Antworten mit Informationen zum Darstellungsbereich
Die Darstellungsbereich-Antwort gibt an, für welche Bereiche Bilder verfügbar sind und bei welchen Zoomstufen. Eine Antwort mit Darstellungsbereichsinformationen 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 String für die Quellenangabe, den Sie auf Ihrer Karte anzeigen müssen, wenn Sie Straßen- und Satellitenkacheln anzeigen. Weitere Informationen finden Sie in den Map Tiles API-Richtlinien.
maxZoomRect- Enthält ein Array von Begrenzungsrechtecken, die sich mit dem aktuellen Darstellungsbereich überschneiden. Enthält auch die maximale Zoomstufe, die in jedem Rechteck verfügbar ist.
Funktionen für Kachelkoordinaten
In den meisten Programmiersprachen sind Tools (einfache Funktionen) verfügbar, mit denen sich Breiten-/Längengradpaare in Kachelkoordinaten bei einer bestimmten Zoomstufe umwandeln lassen.
Sehen Sie sich das folgende JavaScript-Codebeispiel an, in dem zuerst eine latLng in einen Punkt und dann ein Punkt in Kachelkoordinaten umgewandelt wird.
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
};
}