Eine Karten-ID ist eine eindeutige Kennung, die eine einzelne Instanz einer Google Maps-Karte darstellt. Mithilfe von Karten-IDs können Sie Funktionen aktivieren oder Karten auf Ihren Websites und in Ihren Anwendungen verwalten oder stilisieren. Sie können Karten-IDs für jede benötigte Plattform (JavaScript, Android, iOS oder statische Karten) in Ihrem Google Cloud Console-Projekt auf der Seite Kartenverwaltung erstellen.
Weitere Informationen und Funktionen, bei denen Karten-IDs verwendet werden, finden Sie unter Karten-IDs – Übersicht.
Erforderliche Berechtigungen
Wenn Sie Karten-IDs in Ihrem Projekt erstellen oder verwalten möchten, müssen Sie auf der IAM-Seite der Cloud Console für das Projekt ein Hauptkonto mit den entsprechenden Berechtigungen auf Rollenebene (Bearbeiter oder Inhaber) verwenden. Weitere Informationen finden Sie in der Referenz zu einfachen und vordefinierten IAM-Rollen.
Karten-IDs erstellen
So erstellen Sie Karten-IDs in der Cloud Console:
Melden Sie sich in der Cloud Console an und öffnen Sie ein Projekt mit den erforderlichen Berechtigungen.
Rufen Sie in der Cloud Console die Seite Kartenverwaltung auf.
Klicken Sie auf Karten-ID erstellen.
Führen Sie auf der Seite Neue Karten-ID erstellen die folgenden Schritte aus:
- Geben Sie unter Name einen Namen für die Karten-ID ein.
- Optional: Geben Sie unter Beschreibung an, wofür die Karten-ID verwendet wird.
- Wählen Sie unter Kartentyp die Plattform aus, auf der Sie die Karten-ID verwenden möchten. Wenn Sie JavaScript auswählen, wählen Sie auch den Kartentyp Raster (Standard) oder Vektor aus. Weitere Informationen zu Vektorkarten finden Sie unter Vektorkarten.
- Klicken Sie auf Speichern, um die neue Karten-ID zu sehen.
Karten-ID mit einem Kartenstil verknüpfen
Wenn Sie das cloudbasierte Gestalten von Karteninhalten verwenden, ordnen Sie Ihrer Karten-ID einen Kartenstil zu. Weitere Informationen finden Sie unter Verknüpfen.
Karten-ID zur App hinzufügen
Android
Sie können Ihre Karten-ID mit einem <fragment>-Element in der Layoutdatei der Aktivität über die Klasse MapView oder programmatisch über die Klasse GoogleMapOptions hinzufügen.
Angenommen, Sie haben eine Karten-ID erstellt, die als Stringwert map_id in res/values/strings.xml gespeichert ist:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">MAP_ID</string>
</resources>
Bei Karten, die über ein <fragment>-Element in der Layoutdatei der Aktivität hinzugefügt werden, muss für alle Kartenfragmente, die den benutzerdefinierten Stil haben sollen, die Karten-ID im Attribut map:mapId angegeben werden:
<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
map:name="com.google.android.gms.maps.SupportMapFragment"
…
map:mapId="@string/map_id" />
Sie können auch das Attribut map:mapId der Klasse MapView verwenden, um eine Karten-ID anzugeben:
<com.google.android.gms.maps.MapView
xmlns:android="http://schemas.android.com/apk/res/android"
....
map:mapId="@string/map_id" />
Wenn Sie eine Karten-ID programmatisch angeben möchten, übergeben Sie sie mithilfe der Klasse GoogleMapOptions an eine MapFragment-Instanz:
Java
MapFragment mapFragment = MapFragment.newInstance(
new GoogleMapOptions()
.mapId(getResources().getString(R.string.map_id)));
Kotlin
val mapFragment = MapFragment.newInstance(
GoogleMapOptions()
.mapId(resources.getString(R.string.map_id))
)
Erstellen Sie wie gewohnt Ihre App in Android Studio und führen Sie sie aus. Benutzerdefinierte Stile, die im ersten Schritt konfiguriert wurden, werden auf alle Karten mit der angegebenen Karten-ID angewendet.
iOS
So instanziieren Sie eine Karte mit einer Karten-ID:
- Erstelle eine
GMSMapIDmit dem String der Karten-ID aus der Cloud Console. - Erstellen Sie eine
GMSMapViewund geben Sie dabei die soeben erstellte Karten-ID an.
Swift
let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)
let mapID = GMSMapID(identifier: "MAP_ID")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: camera)
self.view = mapView
Objective-C
GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.0169
longitude:-122.336471
zoom:12];
GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"MAP_ID"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;
Wenn Sie eine eigene Karten-ID verwenden, können Sie in der Cloud Console jederzeit einen neuen Stil für Ihre Karten-ID festlegen. Dieser Stil wird dann innerhalb von etwa sechs Stunden automatisch in Ihrer Kartenansicht für Sie und Ihre Nutzer angezeigt.
Wenn Sie die Änderungen sofort sehen möchten, können Sie die App schließen und neu starten. Schließen Sie dazu die App, beenden Sie sie aus der Liste der zuletzt verwendeten Apps und öffnen Sie sie dann wieder. Die aktualisierte Karte ist dann sichtbar.
JavaScript
So erstellen Sie eine Karte mit einer Karten-ID in Ihrem Anwendungscode:
Wenn Sie Ihre Karte bereits mit eingebettetem JSON-Code anpassen, entfernen Sie das
styles-Attribut aus demMapOptions-Objekt. Andernfalls überspringen Sie diesen Schritt.Fügen Sie der Karte mithilfe der Eigenschaft
mapIdeine Karten-ID hinzu. Beispiel:
map = new google.maps.Map(document.getElementById('map'), { center: {lat: -34.397, lng: 150.644}, zoom: 8, mapId: 'MAP_ID' });
Maps Static
Wenn Sie einer neuen oder vorhandenen Karte, die eine unserer Web-Dienst-APIs verwendet, eine Karten-ID hinzufügen möchten, hängen Sie den URL-Parameter map_id an und legen Sie ihn auf Ihre Karten-ID fest. In diesem Beispiel wird gezeigt, wie einer Karte mithilfe der Maps Static API eine Karten-ID hinzugefügt wird.
<img src="https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&size=600x300&maptype=roadmap&markers=color:blue%7Clabel:S%7C40.702147,-74.015794&markers=color:green%7Clabel:G%7C40.711614,-74.012318&markers=color:red%7Clabel:C%7C40.718217,-73.998284&key=YOUR_API_KEY&map_id=MAP_ID&signature=YOUR_SIGNATURE" />