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.

<script async
    src="https://maps.googleapis.com/maps/api/js?v=weekly
        &key=YOUR_API_KEY&callback=initMap">
</script>

<script async
    src="https://maps.googleapis.com/maps/api/js?v=quarterly
        &key=YOUR_API_KEY&callback=initMap">
</script>

<script async
    src="https://maps.googleapis.com/maps/api/js?v=beta
        &key=YOUR_API_KEY&callback=initMap">
</script>

  <script async
      src="https://maps.googleapis.com/maps/api/js?v=alpha
          &key=YOUR_API_KEY&callback=initMap">
  </script>
  

<script async
    src="https://maps.googleapis.com/maps/api/js?v=3.57
        &key=YOUR_API_KEY&callback=initMap">
</script>

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. 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 aktualisiert auf Version 3.58. 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 einführen. 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. 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. 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. 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:

• <ph type="x-smartling-placeholder"></ph> API-Referenz Version 3.58 (wöchentlicher Kanal)
• <ph type="x-smartling-placeholder"></ph> API-Referenz Version 3.57 (vierteljährlicher Kanal)
• <ph type="x-smartling-placeholder"></ph> API-Referenz Version 3.56
• <ph type="x-smartling-placeholder"></ph> API-Referenz Version 3.55
• Versionen 3.0 bis 3.54 wurden gelöscht.