Konzepte

Entwicklungen für mobile Geräte

Bei der Entwicklung von Google Maps JavaScript API wurde darauf geachtet, dass die API schnell geladen werden kann und problemlos auf mobilen Geräten funktioniert. Insbesondere wurden bei der Entwicklung anspruchsvolle mobile Geräte, z. B. Android- und iOS-Smartphones berücksichtigt. Die Bildschirmgröße von mobilen Geräten ist kleiner als typische Browser auf dem Desktop. Außerdem ist für diese Geräte häufig ein spezielles Verhalten (z. B. das Zusammenführen von zwei Fingern zum Zoomen) typisch. Damit Ihre Anwendung problemlos auf mobilen Geräten funktioniert, empfehlen wir Folgendes:

Legen Sie für den Bereich <div>, der Ihre Karte enthält, Breiten- und Höhenattribute von 100% fest. Beachten Sie jedoch, dass bei einigen älteren Browserversionen mit diesen Werten keine gute Darstellung erreicht wird.

Zur Erkennung von iPhone- und Android-Geräten überprüfen Sie die Eigenschaft navigator.userAgent im DOM:

function detectBrowser() {
  var useragent = navigator.userAgent;
  var mapdiv = document.getElementById("map");

  if (useragent.indexOf('iPhone') != -1 || useragent.indexOf('Android') != -1 ) {
    mapdiv.style.width = '100%';
    mapdiv.style.height = '100%';
  } else {
    mapdiv.style.width = '600px';
    mapdiv.style.height = '800px';
  }
}

Auf diese Weise können Sie das Layout für bestimmte Geräte anpassen, wie hier zum Ändern des Bildschirmplatzes für die einzelnen Geräte vorgenommen.

Android- und iOS-Geräte berücksichtigen den folgenden <meta>-Tag:
```
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
```
Diese Einstellung gibt vor, dass die Karte im Vollbildmodus angezeigt wird und eine Größenänderung durch den Benutzer nicht möglich ist. Beachten Sie, dass für den Safari-Browser auf iPhones dieser <meta>-Tag in das Element <head> der Seite eingefügt werden muss.

Weitere Informationen zur Entwicklung für iPhones finden Sie in der Apple-Entwicklerdokumentation. Weitere Informationen zur Entwicklung für Android-Geräte finden Sie in der Android-Entwicklerdokumentation.

Lokalisierung

Sie können Ihre Maps API-Anwendung entweder lokalisieren, indem Sie die Standardspracheinstellungen ändern, oder durch Festlegen des Regionscodes der Anwendung. Der Regionscode verändert das Verhalten der Anwendung auf Grundlage eines bestimmten Landes oder Gebiets.

Sprachlokalisierung

Google Maps API verwendet die bevorzugte Spracheinstellung des Browsers für die Anzeige von Textinformationen, wie die Namen von Steuerelementen, Copyright-Hinweise, Wegbeschreibungen sowie Beschriftungen auf Karten. In den meisten Fällen ist dies zu bevorzugen, da es normalerweise nicht erwünscht ist, die vom Benutzer bevorzugten Spracheinstellungen zu übersteuern. Wenn die Spracheinstellung des Browsers von Maps API dennoch ignoriert werden soll und stattdessen Informationen in einer bestimmen Sprache angezeigt werden sollen, können Sie beim Hinzufügen des Maps API JavaScript-Codes einen optionalen Parameter language zum Tag <script> hinzufügen, mit dem die zu verwendende Sprache vorgegeben wird.

Um beispielsweise eine Maps API-Anwendung auf Japanisch anzuzeigen, fügen Sie &language=ja zum Tag <script> hinzu, wie hier dargestellt:

<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&language=ja"
type="text/javascript">
</script>

Hinweis: Wenn die API wie oben dargestellt geladen wird, wird die Sprache Japanisch unabhängig von den Benutzervoreinstellungen für alle Benutzer verwendet. Stellen Sie absolut sicher, dass dieses Verhalten gewünscht ist, bevor Sie diese Option definieren.

Beispiel anzeigen (map-language.html)

Maps Javascript API unterstützt außerdem bidirektionalen Text (Bidi) mit Zeichen für Sprachen, die von links nach rechts (Left-to-Right, LTR) oder von rechts nach links (Right-to-Left, RTL) verlaufen. Zu den RTL-Sprachen gehören Arabisch, Hebräisch und Farsi. Damit Seiten in RTL-Sprachen korrekt wiedergegeben werden, fügen Sie dir='rtl' zum Seitenelement <html> hinzu. Im nachfolgenden Beispiel wird eine Karte von Kairo, Ägypten, mit arabischen Steuerelementen wiedergegeben:

Beispiel anzeigen (map-rtl.html)

Weitere Informationen finden Sie in der Liste der unterstützten Sprachen. Beachten Sie, dass die unterstützten Sprachen häufig aktualisiert werden. Die Liste ist ggf. nicht vollständig.

Regionslokalisierung

Wenn Sie Maps API von maps.googleapis.com laden, wird ein Standard-Biasing angewandt, das eine Bevorzugung der USA bewirkt. Wenn Sie Ihre Anwendung so verändern möchten, dass verschiedene Kartenkacheln bedient werden, oder wenn Sie ein Biasing für die Anwendung vornehmen möchten (z. B. das Bevorzugen von Geocoding-Ergebnissen einer bestimmten Region), können Sie dieses Standardverhalten übersteuern, indem Sie beim Hinzufügen des Maps API JavaScript-Codes einen Parameter region zum Tag <script> hinzufügen.

Als Entwickler einer Maps API-Anwendung sind Sie dafür verantwortlich sicherzustellen, dass Ihre Anwendung den vor Ort geltenden gesetzlichen Vorgaben entspricht, indem Sie dafür sorgen, dass die korrekte Regionslokalisierung für das jeweilige Land, in dem die Anwendung gehostet ist, zur Anwendung kommt.

Der Parameter region lässt Unicode-Subtags als Regionsbezeichner zu, die (in der Regel) dem Ländercode der Top-Level-Domain (ccTLD) eins-zu-eins zugeordnet sind. Die meisten Unicode-Regionsbezeichner stimmen mit den ISO 3166-1-Codes überein, wobei es einige Ausnahmen gibt. So ist z. B. der ccTLD für Großbritannien „uk“ (entsprechend der Domäne .co.uk), während der Regionsbezeichner „GB“ lautet.

Um beispielsweise eine Maps API-Anwendung zu verwenden, die für Großbritannien lokalisiert ist, fügen Sie &region=GB zum Tag <script> hinzu, wie hier dargestellt:

<script type="text/javascript" src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&region=GB"
type="text/javascript">
</script>

In den folgenden Beispielen werden zwei Karten dargestellt. Bei der einen Karte ist „Toledo“ basierend auf der Standardregion (US) auf „Toledo, Ohio“ geocodiert, bei der anderen werden die Ergebnisse basierend auf der Einstellung ES (Spanien) für region auf „Toledo, Spanien“ geocodiert.

Laden der API in China

In China werden Google Maps APIs über die Domäne http://maps.google.cn geladen. Um Inhalte für China bereitzustellen, ersetzen Sie https://maps.googleapis.com durch http://maps.google.cn. Beispiel:

<script src="http://maps.google.cn/maps/api/js?key=YOUR_API_KEY"
type="text/javascript">
</script>

Wenn Ihre Zielgruppe explizit Benutzer in China anspricht, ist es ggf. sinnvoll, auch die Region und die Sprachparameter hinzuzufügen. Von der API werden sowohl zh-CN als auch zh-TW als Werte für den Parameter language unterstützt.

<script src="http://maps.google.cn/maps/api/js?region=cn&language=zh-CN&key=YOUR_API_KEY"
type="text/javascript">
</script>

Versionsverwaltung

Das Google Maps JavaScript API-Team aktualisiert die API regelmäßig mit neuen Funktionen, Fehlerkorrekturen und Leistungsverbesserungen. Sie können angeben, welche Version der API in Ihre Anwendung importiert werden soll, indem Sie dies im Parameter v der Google Maps JavaScript API-Bootstrapanforderung angeben. Weitere Informationen zur Versionsverwaltung.