Eine Karten-ID ist eine eindeutige Kennung, die in Google Cloud gespeicherte Stil- und Konfigurationseinstellungen für Google Maps darstellt. Mit Karten-IDs können Sie Funktionen aktivieren oder Karten auf Ihren Websites und in Ihren Anwendungen verwalten oder gestalten. Sie können in Ihrem Google Cloud Console-Projekt auf der Seite Kartenverwaltung Karten-IDs für jede benötigte Plattform erstellen: JavaScript, Android, iOS oder statische Karten.
Weitere Informationen und Funktionen, die Karten-IDs verwenden, finden Sie unter Karten-ID – Übersicht.
Erforderliche Berechtigungen
Zum Erstellen oder Verwalten von Karten-IDs in Ihrem Projekt müssen Sie ein Hauptkonto mit den entsprechenden Berechtigungen auf Rollenebene (Bearbeiter oder Inhaber) auf der IAM-Seite der Cloud Console für das Projekt 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 einem Cloud Console-Projekt mit den erforderlichen Berechtigungen an und öffnen Sie es.
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 folgende 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, müssen Sie auch den Kartentyp Raster (Standard) oder Vektor auswählen. 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, verknüpfen Sie einen Kartenstil mit Ihrer Karten-ID. Weitere Informationen finden Sie unter Stil mit einer Karten-ID verknüpfen.
Karten-ID in App einbinden
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:map="http://schemas.android.com/apk/res-auto"
....
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:
- Erstellen Sie ein
GMSMapIDmit dem Karten-ID-String aus der Cloud Console. - Erstellen Sie ein
GMSMapViewmit der Karten-ID, die Sie gerade erstellt haben.
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 Ihre 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 auf Ihrer Karte für Sie und Ihre Nutzer übernommen.
Wenn Sie die Änderungen sofort sehen möchten, können Sie die App schließen und neu starten. Beenden Sie dazu die App, erzwingen Sie das Schließen der App über die Liste der zuletzt verwendeten Apps und öffnen Sie sie dann wieder. Die aktualisierte Karte wird dann angezeigt.
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 IhremMapOptions-Objekt. Andernfalls überspringen Sie diesen Schritt.Fügen Sie der Karte mit 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, für die eine unserer Webdienst-APIs verwendet wird, 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" />