Versionsverwaltung

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.

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.