Es kann losgehen!

Bevor Sie mit der Entwicklung beginnen, lesen Sie bitte unsere Entwicklerdokumentation.

Die Google Maps JavaScript API aktivieren

Zum Einstieg führen wir Sie durch die Google Developers Console, wo Sie vorab Folgendes tun müssen:

  1. Ein Projekt erstellen oder auswählen
  2. Die Google Maps JavaScript API und zugehörige Dienste aktivieren
  3. Zugehörige Schlüssel erstellen
Weiter

Get a Key/Authentication

Alle Google Maps JavaScript API-Anwendungen erfordern eine Authentifizierung.

  • Standard-API-Nutzer: Wenn Sie die API dem Standard Plan gemäß nutzen, müssen Sie einen API-Schlüssel verwenden, der in einem Projekt Ihrer Wahl eingerichtet wurde. Lesen Sie weitere Informationen über API-Schlüssel für die Standard-API.
  • Premium Plan-Nutzer: Wenn Sie die API dem Google Maps APIs Premium Plan gemäß nutzen, haben Sie zwei Authentifizierungsmöglichkeiten:
    • Verwenden Sie einen API-Schlüssel, der im Rahmen des Google Maps APIs Premium Plan-Projekts eingerichtet wurde, das beim Kauf des Premium Plan für Sie angelegt wurde
        oder
    • Verwenden Sie anstatt eines API-Schlüssels Ihre Client-ID.

    Informationen zur Auswahl der besten Authentifizierungsmethode finden Sie im nachfolgenden Abschnitt Google Maps APIs Premium Plan.

Authentifizierung für die Standard-API – API-Schlüssel

Um die Standard-API zu verwenden, müssen Sie beim Laden der API einen API-Schlüssel einschließen.

Vorteile der Verwendung eines API-Schlüssels:

  • Mit dem API-Schlüssel können Sie die Nutzung der API Ihrer Anwendung in der Google API Console überwachen. Weitere Informationen finden Sie unter Hilfe zur Google API Console.
  • Mit einem Schlüssel haben Sie Zugriff auf ein großzügiges kostenloses Tageskontingent. Außerdem haben Sie die Möglichkeit, durch Aktivieren der Vorausbezahlung Ihr Tageskontingent zu erhöhen.
  • Mit der Anmeldung für einen API-Schlüssel stellen Sie sicher, dass Google Sie ggf. bezüglich Ihrer Anwendung kontaktieren kann.

API-Schlüssel anfordern

Für die ersten Schritte bei der Verwendung von Google Maps JavaScript API klicken Sie auf die folgende Schaltfläche. Sie werden nun durch den Vorgang zur automatischen Aktivierung der Google Maps JavaScript API und zugehöriger Dienste geleitet.

Schlüssel anfordern

Alternativ können Sie auch wie folgt einen API-Schlüssel anfordern:

  1. Navigieren Sie zu Google API Console.
  2. Ein Projekt erstellen oder auswählen
  3. Klicken Sie auf Continue, um die API und zugehörige Dienste zu aktivieren.
  4. Fordern Sie auf der Seite Credentials einen API-Schlüssel an (und legen Sie die Einschränkungen für den API-Schlüssel fest).
    Hinweis: Wenn Sie bereits über einen API-Schlüssel ohne Einschränkungen oder einen Schlüssel mit Browsereinschränkungen verfügen, können Sie diesen Schlüssel verwenden.
  5. Um Kontingentdiebstahl zu verhindern, schützen Sie Ihren API-Schlüssel anhand der bewährten Methoden.
  6. (Optional) Abrechnung aktivieren. Weitere Informationen finden Sie unter Nutzungsbeschränkungen.


In der Google API Console können Sie auch einen vorhandenen Schlüssel suchen oder eine Liste aktivierter APIs ansehen.

Weitere Informationen zur Verwendung der Google API Console finden Sie in der Hilfe zur API Console.

Einschränkungstypen für API-Schlüssel

Google Maps APIs sind für Android- oder iOS-Apps, Webbrowser und über HTTP-Webdienste verfügbar. Ein generischer (nicht eingeschränkter) API-Schlüssel kann für APIs auf jeder beliebigen Plattform verwendet werden. Optional können Sie dem API-Schlüssel eine Einschränkung hinzufügen (zum Beispiel den HTTP-Referrer). Nach der Einschränkung funktioniert der Schlüssel nur auf Plattformen, die den jeweiligen Einschränkungstyp unterstützen. Weitere Infos zu Schlüsseln und Anmeldedaten.

Beim Laden der API einen Schlüssel angeben

Um einen Schlüssel anzugeben, schließen Sie ihn beim Laden der API in Form des Werts eines key-Parameters ein.

Beispiel:

  <script async defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
  type="text/javascript"></script>

Authentifizierung für Google Maps APIs Premium Plan-Kunden

Die Informationen in diesem Abschnitt gelten nur für den neuen Google Maps APIs Premium Plan, der seit dem 6. Januar 2016 erhältlich ist.



Besitzen Sie eine frühere Maps APIs for Work- oder Maps API for Business-Lizenz? Lesen Sie unseren Leitfaden zuMaps APIs for Work-Lizenzen. So bestimmen Sie, ob Sie eine frühere Lizenz besitzen: Klicken Sie im Google Cloud Support Portal auf der linken Seite auf Maps: Usage Report. Wenn die ID oben im Bericht das folgende Format aufweist, nutzen Sie den neuen Premium Plan:
gme-[company] & proj-[number] ([type])
Anderenfalls besitzen Sie eine frühere Lizenz.

Bei Verwendung der Google Maps JavaScript API mit einer Google Maps APIs Premium Plan-Lizenz müssen Sie Ihre Anwendung entweder mit einem API-Schlüssel oder mit einer Client-ID authentifizieren. Hinweis: Wenn Sie bereits über eine frühere Maps API for Business-Lizenz verfügen, müssen Sie eine Client-ID verwenden. Ein API-Schlüssel kann in diesem Fall nicht verwendet werden.

Bei Ihren Überlegungen dazu, welche Authentifizierungsmethode Sie verwenden wollen, beachten Sie bitte Folgendes:

  • API-Schlüssel (erhältlich für Google Maps APIs Premium Plan-Kunden, aber nicht für Inhaber einer früheren Maps API for Business-Lizenz) – Bei Verwendung eines API-Schlüssels für die Authentifizierung von Anforderungen können Sie:
  • Client-ID – Bei Verwendung Ihrer Client-ID (anstatt eines API-Schlüssels) zur Authentifizierung von Anforderungen können Sie:
    • den Parameter channel zu Anforderungen hinzufügen, damit Sie detailliertere Nutzungsberichte ansehen können
    • Nutzungsberichte mit Daten für mehr als 30 Tage im Google Cloud Support Portal ansehen
    • Maps Analytics-Tools für die Maps JavaScript API verwenden

Lesen Sie weitere Informationen zu Berichten, die für Premium Plan-Kunden verfügbar sind.

Verwenden eines API-Schlüssels

Zur Authentifizierung der Google Maps JavaScript API mit einem API-Schlüssel klicken Sie auf die folgende Schaltfläche. Sie werden dann durch den Vorgang zum Anfordern eines API-Schlüssels geleitet.

Wichtig: Achten Sie darauf, im Drop-down-Menü „Project“ das Projekt auszuwählen, das beim Kauf vom Premium Plan für Sie angelegt wurde. Der Projektname beginnt mit Google Maps APIs for Business or Google Maps for Work or Google Maps.*

Schlüssel anfordern

Alternativ können Sie auch wie folgt einen API-Schlüssel anfordern:

  1. Navigieren Sie zu Google API Console.
  2. Wählen Sie im Drop-down-Menü des Projekts das Projekt Google Maps Premium aus.*
  3. Klicken Sie auf Continue.
  4. Fordern Sie auf der Seite Credentials einen API-Schlüssel an (und legen Sie die Einschränkungen für den API-Schlüssel fest).
    Hinweis: Wenn Sie bereits über einen API-Schlüssel ohne Einschränkungen oder einen Schlüssel mit Browsereinschränkungen verfügen, können Sie diesen Schlüssel verwenden.
  5. Um Kontingentdiebstahl zu verhindern, schützen Sie Ihren API-Schlüssel anhand der bewährten Methoden.

* Hinweis: Achten Sie darauf, im Drop-down-Menü des Projekts das Projekt auszuwählen, das beim Kauf von Premium Plan für Sie angelegt wurde. Der Projektname beginnt mit Google Maps APIs for Business or Google Maps for Work or Google Maps. Wichtig: Wenn Sie bereits über eine frühere Maps API for Business-Lizenz verfügen, müssen Sie eine Client-ID verwenden. Ein API-Schlüssel kann in diesem Fall nicht verwendet werden.


Sie können auch nach einem vorhandenen Schlüssel in Google API Console suchen.

Weitere Informationen zur Verwendung der Google API Console finden Sie in der Hilfe zur API Console.

Beim Laden der API einen Schlüssel angeben

Um einen Schlüssel anzugeben, schließen Sie ihn beim Laden der API in Form des Werts eines key-Parameters ein.

Beispiel:

  <script async defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
  type="text/javascript"></script>

Verwenden einer Client-ID

Die Authentifizierung der Google Maps JavaScript API mit einer Client-ID (anstatt eines API-Schlüssels) erfordert eine eindeutige Client-ID in Verbindung mit der URL-Registrierung.

Falls Sie zuvor für die Authentifizierung einen API-Schlüssel verwendet haben und nun eine Client-ID verwenden wollen, müssen Sie den key-Parameter entfernen, bevor Sie die API laden. Wenn sowohl eine Client-ID als auch ein API-Schlüssel eingeschlossen werden, führt dies dazu, dass das Laden der API fehlschlägt..

Ihre Client-ID

Nachdem Sie eine Google Maps APIs Premium Plan-Lizenz erworben haben, erhalten Sie eine Begrüßungs-E-Mail von Google. Diese E-Mail enthält Ihre Client-ID. Mit Ihrer Client-ID erhalten Sie Zugriff auf die Sonderfunktionen vom Google Maps APIs Premium Plan. Alle Client-IDs beginnen mit dem Präfix gme-.

Diese Client-ID ist kein Schlüssel. Sie funktioniert nur von URLs aus, die Sie autorisiert haben. Sie brauchen sich also keine Gedanken um die Geheimhaltung zu machen.

Beim Laden der API eine Client-ID angeben

Geben Sie beim Laden der Google Maps JavaScript API Ihre Client-ID in Form des Werts eines Parameters vom Typ client an:

<script async defer src="https://maps.googleapis.com/maps/api/js?client=YOUR_CLIENT_ID &v=3.26&callback=initMap"></script>

Wie im oben dargestellten Beispiel gezeigt, müssen Sie die Release-Version (auch als funktionsstabile Version bezeichnet) oder eine frühere Version angeben, indem Sie den Parameter v=3.26 anfügen. Anwendungen, die die experimentelle Version verwenden, sind nicht durch das SLA für Google Maps APIs Premium Plan abgedeckt.

Registrieren autorisierter URLs



Um zu verhindern, dass Ihre Client-ID durch einen Dritten auf dessen eigener Website genutzt wird, ist Ihre Client-ID auf eine Liste von URLs eingeschränkt, die von Ihnen speziell autorisiert wurden.

So zeigen Sie die URLs an, die Sie bereits autorisiert haben, oder autorisieren Sie weitere URLs:

  1. Melden Sie sich im Google Cloud Support Portal an.
  2. Klicken Sie im Menü auf der linken Seite auf Maps: Manage Client ID.

Sie können bis zu 100 URLs auf einmal hinzufügen. Die Gesamtzahl der URLs beträgt 3.000. Falls Sie höhere Grenzwerte benötigen, wenden Sie sich an den Support.

Hinsichtlich autorisierter URLs ist Folgendes zu beachten:

Der Domänenname oder die IP-Adresse muss nicht öffentlich zugänglich sein.
Zum Beispiel sind http://myintranet und http://192.168.1.1 gültige Einträge.
Alle Unterdomänen einer angegebenen Domäne sind ebenfalls autorisiert.
Wenn zum Beispiel http://example.com autorisiert ist, dann ist http://www.example.com ebenfalls autorisiert. Das Gegenteil gilt nicht: Wenn http://www.example.com autorisiert ist, ist http://example.com nicht notwendigerweise ebenfalls autorisiert.
Alle Unterpfade eines autorisierten Pfades sind ebenfalls autorisiert.
Wenn zum Beispiel http://example.com autorisiert ist, dann ist http://example.com/foo ebenfalls autorisiert. Zusätzlich gilt: Da Unterdomänen einer angegebenen Domäne autorisiert sind, ist auch http://sub.example.com/bar autorisiert.
Bei Pfaden wird zwischen Groß- und Kleinschreibung unterschieden.
Zum Beispiel ist http://www.example.com/ThisPath/ ein anderer Pfad als http://www.example.com/thispath/.
Sie können gültige URLs auf bestimmte Ports beschränken.
Wenn zum Beispiel http://example.com:8080/foo angegeben ist, wird dadurch http://example.com nicht autorisiert.
URLs, die das HTTP-Protokoll verwenden, und solche, die das HTTPS-Protokoll verwenden, gelten als unterschiedliche URLs.
Wenn zum Beispiel https://example.com autorisiert ist, ist http://example.com nicht notwendigerweise ebenfalls autorisiert. Wenn beide auf einmal autorisiert werden sollen, können Sie eine Domäne ohne Protokollangabe eintragen: example.com/

Alle oben aufgeführten Regeln werden auf jede Autorisierung angewandt. Sie sollten daher Ihre Autorisierungen sorgfältig planen. Beispielsweise gilt: Dadurch, dass alle Unterpfade eines angegebenen Pfades autorisiert sind, ebenso wie auch alle Unterdomänen, kann es passieren, dass Sie Seiten autorisieren, die eigentlich nicht autorisiert werden sollten. Beispiel:

Durch http://example.com/ ist auch http://sub.example.com/path autorisiert.

Weitere Informationen finden Sie unter Fehlerbehebung im Zusammenhang mit der Google Maps APIs Premium Plan-Autorisierung.

Feedback geben zu...

Google Maps JavaScript API
Google Maps JavaScript API