Versionsverwaltung

Die Maps JavaScript API wird regelmäßig aktualisiert, um neue Funktionen einzuführen, Fehler zu korrigieren und die Leistung zu verbessern. Auf dieser Seite werden die API-Versionen beschrieben, die Sie in Ihren Anwendungen verwenden können.

Releasekanäle und Versionsnummern

Sie können in Ihrer Anwendung Releasekanäle oder Versionsnummern angeben:

  • Der wöchentliche Kanal wird mit v=weekly angegeben.
    Er wird einmal pro Woche aktualisiert und ist der aktuellste.
  • Der vierteljährliche Kanal wird mit v=quarterly angegeben.
    Er wird einmal im Quartal aktualisiert und bietet die beste Planbarkeit.
  • Der Betakanal wird mit v=beta angegeben.
    Er basiert auf dem wöchentlichen Kanal (weekly) und wird einmal pro Woche aktualisiert. Er enthält zusätzliche Änderungen für erste Tests und Feedback.
  • Der Alphakanal wird mit v=alpha angegeben.
    Er basiert auf dem Betakanal (beta) und wird einmal pro Woche aktualisiert. Er umfasst Tests für Kundenfeedback zu Prototypen. Er ist nur für Entwicklungszwecke vorgesehen und sollte nicht in der Produktion verwendet werden.
  • Die Versionsnummer wird mit v=n.nn angegeben.
    Sie können v=3.58, v=3.57, v=3.56 oder v=3.55 auswählen.
    Versionsnummern werden einmal pro Quartal aktualisiert (siehe Vierteljährliche Updates).

Wenn Sie den Releasekanal oder die Versionsnummer nicht angeben, erhalten Sie standardmäßig den wöchentlichen Kanal. Wenn Sie von der Premiumoption migrieren und Releasekanal oder Versionsnummer nicht explizit angeben, erhalten Sie standardmäßig den vierteljährlichen Kanal. Wenn Sie eine ungültige Version angeben, erhalten Sie den jeweiligen Standardkanal.

Wöchentlichen Kanal auswählen

Für die meisten Anwendungen empfehlen wir den wöchentlichen Kanal. Er ist der aktuellste und enthält die neuesten Fehlerkorrekturen und Leistungsverbesserungen. Sie können ihn angeben, indem Sie die Maps JavaScript API mit dem folgenden Script-Tag laden:

  <script>
    (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
      key: "YOUR_API_KEY",
      v: "weekly",
    });
  </script>

Der wöchentliche Kanal verweist derzeit auf Version 3.58. Diese Version wird wöchentlich aktualisiert, um neue Funktionen einzuführen, Fehler zu korrigieren und die Leistung zu verbessern.

Mitte November wird der wöchentliche Kanal auf Version 3.59 aktualisiert. Mit der neuen Version werden möglicherweise nicht mehr unterstützte Funktionen entfernt und/oder Abwärtsinkompatibilitäten eingeführt.

Vierteljährlichen Kanal auswählen

Einige Anwendungen profitieren eventuell von weniger, aber umfangreicheren Aktualisierungen, da diese eine größere Planungssicherheit bieten. Hier sollte der vierteljährliche Kanal verwendet werden. Wählen Sie ihn aus, wenn Sie Fehlerkorrekturen und Leistungsverbesserungen zu einem bestimmten Zeitpunkt erhalten möchten (siehe Vierteljährliche Updates). Sie können den vierteljährlichen Kanal angeben, indem Sie die Maps JavaScript API mit dem folgenden Script-Tag laden:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "quarterly",
  });
  </script>

Der vierteljährliche Kanal verweist derzeit auf Version 3.57. Während des Quartals erhält diese Version keine neuen Funktionen, Fehlerkorrekturen oder Leistungsverbesserungen. Gelegentlich kann sie aber Fehlerkorrekturen zur Sicherheitsverbesserung erhalten.

Mitte November wird der vierteljährliche Kanal auf Version 3.58 aktualisiert. Mit der neuen Version werden neue Funktionen eingeführt, nicht mehr unterstützte Funktionen entfernt und/oder Abwärtsinkompatibilitäten der vorherigen drei Monate eingeführt.

Betakanal auswählen

Wenn Sie den Betakanal verwenden, können Sie neue Betafunktionen und Änderungen ausprobieren. Betafunktionen sind funktional vollständig, weisen aber eventuell noch Probleme auf. Bitte verwenden Sie den Issue Tracker, um Probleme zu melden und Feedback zu geben. Der Betakanal unterliegt weder einem SLA noch einer Richtlinie zur Einstellung von Produkten und Diensten. Außerdem sind einige Änderungen eventuell nicht abwärtskompatibel mit früheren Releases.

Dieser Kanal basiert auf dem wöchentlichen Kanal (weekly). Er wird einmal pro Woche aktualisiert.

Sie können den Betakanal angeben, indem Sie die Maps JavaScript API mit dem folgenden Script-Tag laden:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "beta",
  });
  </script>

Alphakanal auswählen

Verwenden Sie den Alphakanal, wenn Sie neue experimentelle Funktionen und Änderungen testen möchten. Wenn Sie Probleme melden und Feedback geben möchten, nutzen Sie dafür bitte den Issue Tracker. Der Alphakanal unterliegt weder einem SLA noch einer Richtlinie zur Einstellung von Produkten und Diensten. Außerdem sind einige Änderungen eventuell nicht abwärtskompatibel mit früheren Releases. Er ist nur für Entwicklungszwecke vorgesehen und sollte nicht in der Produktion verwendet werden.

Dieser Kanal basiert auf dem Betakanal (beta). Er wird einmal pro Woche aktualisiert.

Sie können den Alphakanal angeben, indem Sie die Maps JavaScript API mit dem folgenden Script-Tag laden:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "alpha",
  });
  </script>

Versionsnummer auswählen

Geben Sie nur dann eine Versionsnummer an, wenn Sie Ihre Anwendung regelmäßig testen und aktualisieren. Nummerierte Versionen werden nämlich gelöscht, wenn jedes Quartal neue Versionen erstellt werden. Sie können die Versionsnummer angeben, indem Sie die Maps JavaScript API mit dem folgenden Script-Tag laden:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: 3.57,
  });
  </script>

Derzeit können Sie v=3.58, v=3.57, v=3.56 oder v=3.55 angeben.

  • Version 3.58 erhält wöchentliche Updates mit neuen Funktionen, Fehlerkorrekturen und Leistungsverbesserungen.
  • Version 3.57 erhält keine wöchentlichen Updates.
  • Version 3.56 erhält keine wöchentlichen Updates.
  • Version 3.55 erhält keine wöchentlichen Updates.
  • Gelegentlich können Versionen Fehlerkorrekturen zur Verbesserung der Sicherheit erhalten.
  • Mit neuen Versionen werden möglicherweise auch abwärtsinkompatible Änderungen eingeführt.

Nach Mitte November können Sie v=3.59, v=3.58, v=3.57 oder v=3.56 angeben.

  • Version 3.59 wird wöchentliche Updates mit neuen Funktionen, Fehlerkorrekturen und Leistungsverbesserungen erhalten.
  • Version 3.58 wird keine wöchentlichen Updates mehr erhalten.
  • Version 3.57 wird keine wöchentlichen Updates mehr erhalten.
  • Version 3.56 wird keine wöchentlichen Updates mehr erhalten.
  • Gelegentlich können Versionen Fehlerkorrekturen zur Verbesserung der Sicherheit erhalten.
  • Version 3.55 wird nicht mehr verfügbar sein. Versuche, diese Version zu laden, werden ignoriert. Sie erhalten stattdessen Ihren Standardkanal.

Das folgende Diagramm zeigt, welche Versionen in den nächsten 12 Monaten in den einzelnen Kanälen verfügbar sein werden.

v3.55v3.56v3.56v3.57v3.57v3.57v3.58v3.58v3.58v3.58v3.59v3.59v3.59v3.60v3.60v3.61

Ein Update hat sich negativ auf meine Anwendung ausgewirkt

Updates der Releasekanäle können sich negativ auf Ihre Anwendung auswirken. Eventuell verwendet Ihre Anwendung undokumentierte oder nicht mehr unterstützte Funktionen oder wir haben einen Fehler oder eine Fehlerbehebung eingeführt.

Sie können das Problem vorübergehend umgehen, indem Sie Ihre Anwendung so konfigurieren, dass eine ältere Version verwendet wird.

  1. Öffnen Sie die Entwicklertools-Konsole des Browsers und sehen Sie sich den Wert von google.maps.version an.
  2. Aktualisieren Sie das Script-Tag, mit dem die API geladen wird, und fordern Sie eine ältere Versionsnummer an.
    Wenn google.maps.version beispielsweise den Wert „3.58.2“ hat, verwenden Sie v=3.57 im Script-Tag.
    Diese Umgehung kann nur vorübergehend verwendet werden.

Sobald sie eingerichtet ist, haben Sie in der Regel 3 bis 6 Monate Zeit, Ihre Anwendung so zu aktualisieren, dass keine undokumentierten oder nicht mehr unterstützten Funktionen mehr verwendet und dass Fehler oder Fehlerkorrekturen berücksichtigt werden.

Kehren Sie dann zum ursprünglichen Script-Tag zurück, um die API zu laden.

Sie können auch eine Supportanfrage erstellen oder ein Problem melden.

Vierteljährliche Updates

Das Maps JavaScript API-Team veröffentlicht einmal pro Quartal eine neue Version. Das geschieht jeweils Mitte Februar, Mitte Mai, Mitte August und Mitte November. Das nächste Update gibt es Mitte November. Der neue wöchentliche Kanal stellt dann Version 3.59 bereit. Auch die anderen Kanäle werden dann aktualisiert.

Update des wöchentlichen Kanals

Der wöchentliche Kanal verweist derzeit auf Version 3.58.

Mitte November wird der wöchentliche Kanal von Version 3.58 auf Version 3.59 aktualisiert. Mit der neuen Version werden neue Funktionen eingeführt, nicht mehr unterstützte Funktionen entfernt und/oder Abwärtsinkompatibilitäten eingeführt. Möglicherweise müssen Sie diese Änderungen testen, wenn der Kanal aktualisiert wird.

Im Laufe des Quartals wird die Version wöchentlich mit neuen Funktionen, Fehlerkorrekturen und Leistungsverbesserungen aktualisiert. Es werden keine nicht mehr unterstützten Funktionen entfernt und keine Abwärtsinkompatibilitäten eingeführt.

Update des vierteljährlichen Kanals

Der vierteljährliche Kanal verweist derzeit auf Version 3.57.

Mitte November wird der vierteljährliche Kanal von Version 3.57 auf Version 3.58 aktualisiert. Mit der neuen Version werden neue Funktionen eingeführt, nicht mehr unterstützte Funktionen entfernt und/oder Abwärtsinkompatibilitäten der vorherigen drei Monate eingeführt. Möglicherweise müssen Sie diese Änderungen testen, wenn der Kanal aktualisiert wird.

Diese Version enthält im Laufe des Quartals keine neuen Funktionen, Fehlerkorrekturen oder Leistungsverbesserungen. Es werden keine nicht mehr unterstützten Funktionen entfernt und keine Abwärtsinkompatibilitäten eingeführt.

Versionsupdates

Aufgrund der Veröffentlichung der neuen Version werden die Versionsnummern Mitte November umgestellt.

Version 3.59

Mitte November wird Version 3.59 veröffentlicht. Mit dieser Version werden neue Funktionen eingeführt, nicht mehr unterstützte Funktionen entfernt und/oder Abwärtsinkompatibilitäten im Vergleich zu Version 3.58 eingeführt. Sie sollten Ihre Anwendung testen, wenn Sie zwischen Versionsnummern wechseln.

Im Laufe des Quartals wird die Version wöchentlich mit neuen Funktionen, Fehlerkorrekturen und Leistungsverbesserungen aktualisiert. Es werden keine nicht mehr unterstützten Funktionen entfernt und keine Abwärtsinkompatibilitäten eingeführt.

Version 3.58

Mit dieser Version werden neue Funktionen eingeführt, nicht mehr unterstützte Funktionen entfernt und/oder Abwärtsinkompatibilitäten im Vergleich zu Version 3.57 eingeführt. Sie sollten Ihre Anwendung testen, wenn Sie zwischen Versionsnummern wechseln.

Nach Mitte November wird diese Version nicht mehr mit neuen Funktionen, Fehlerkorrekturen oder Leistungsverbesserungen aktualisiert. Es werden keine nicht mehr unterstützten Funktionen entfernt und keine Abwärtsinkompatibilitäten eingeführt.

Version 3.57

Mit dieser Version werden neue Funktionen eingeführt, nicht mehr unterstützte Funktionen entfernt und/oder Abwärtsinkompatibilitäten im Vergleich zu Version 3.56 eingeführt. Sie sollten Ihre Anwendung testen, wenn Sie zwischen Versionsnummern wechseln.

Diese Version wird nicht mehr mit neuen Funktionen, Fehlerkorrekturen oder Leistungsverbesserungen aktualisiert. Funktionen, die nach dieser Version nicht mehr unterstützt wurden, werden nicht entfernt und es werden keine neuen Abwärtsinkompatibilitäten eingeführt.

Version 3.56

Mit dieser Version werden neue Funktionen eingeführt, nicht mehr unterstützte Funktionen entfernt und/oder Abwärtsinkompatibilitäten im Vergleich zu Version 3.55 eingeführt. Sie sollten Ihre Anwendung testen, wenn Sie zwischen Versionsnummern wechseln.

Diese Version wird nicht mehr mit neuen Funktionen, Fehlerkorrekturen oder Leistungsverbesserungen aktualisiert. Funktionen, die nach dieser Version nicht mehr unterstützt wurden, werden nicht entfernt und es werden keine neuen Abwärtsinkompatibilitäten eingeführt.

Version 3.55

Nach Mitte November wird diese Version gelöscht und kann nicht mehr verwendet werden. Versuche, diese Version zu laden, werden ignoriert. Sie erhalten stattdessen Ihre standardmäßige Version.

Versionsunterstützung

Pro Quartal sind jeweils vier Versionen verfügbar. Alle vier Versionen werden unterstützt.

Versionsprüfungen

Verwenden Sie für das Debugging die Eigenschaft google.maps.version, um die aktuelle Version der Maps JavaScript API in Ihrer Anwendung abzurufen. Im folgenden Codebeispiel wird die API-Version an die Browserkonsole zurückgegeben. Weitere Informationen zur Browserkonsole finden Sie unter Fehler im Browser überprüfen.

<!DOCTYPE html>
<html>
  <head>
    <title>Display Google Maps API Version</title>
  </head>
  <body>
    <script>
      function initMap() {
        // Add your map here.
        console.log('Google Maps API version: ' + google.maps.version);
      }
    </script>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
    defer></script>
  </body>
</html>

Dokumentation für die API-Versionen

Im Entwicklerhandbuch wird immer die wöchentliche Version beschrieben.

Zusätzlich gibt es für jede Version eine separate Referenz: