Eine Karten-ID ist eine eindeutige Kennung, die die in Google Cloud gespeicherten 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 Static Maps.
Weitere Informationen und Funktionen, die Karten-IDs verwenden, finden Sie unter Übersicht über Karten-IDs.
Erforderliche Berechtigungen
Zum Erstellen oder Verwalten von Karten-IDs in Ihrem Projekt müssen Sie ein Konto mit den entsprechenden Berechtigungen auf Rollenebene verwenden. Das kann die Rolle „Bearbeiter“ oder „Inhaber“ auf der IAM-Seite der Cloud Console für das Projekt sein. Weitere Informationen finden Sie in der Referenz für einfache und vordefinierte 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 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 einen Raster - (Standard) oder Vektor -Kartentyp aus. Weitere Informationen zu Vektorkarten finden Sie unter Vektorkarten.
- Klicken Sie auf Speichern , um Ihre 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 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 in res/values/strings.xml unter dem Namen map_id 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 map:mapId Attribut 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 eine
GMSMapIDmit dem Karten-ID-String aus der Cloud Console. - Erstellen Sie eine
GMSMapViewund geben Sie 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 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 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. Beenden Sie dazu die App, erzwingen Sie das Beenden der App über die Liste der zuletzt verwendeten Apps und öffnen Sie sie dann neu. 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 die
stylesEigenschaft aus IhremMapOptionsObjekt. 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, die eine unserer Webdienst-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 einer Karte mit der Maps Static API eine Karten-ID hinzugefügt.
<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" />