Karte lokalisieren

Wenn Sie Ihre Karte für ein bestimmtes Land oder eine bestimmte Region anpassen möchten, haben Sie folgende Möglichkeiten:

  • Sie ändern die standardmäßigen Spracheinstellungen.
  • Sie geben einen Regionscode an, was dazu führt, dass sich das Kartenverhalten entsprechend dem jeweiligen Land oder Gebiet ändert.

Sprachlokalisierung

Bei der Anzeige von Textinformationen wie Namen von Steuerelementen, Urheberrechtshinweise, Wegbeschreibungen und Labels auf Karten verwendet die Maps JavaScript API standardmäßig die im Browser festgelegte bevorzugte Spracheinstellung des Nutzers. In den meisten Fällen empfiehlt es sich, die Browsereinstellung beizubehalten. Wenn die Spracheinstellung des Browsers von der Maps JavaScript API ignoriert werden soll, können Sie einen language-Parameter in das <script>-Tag einfügen, der mit dem Code der Maps JavaScript API geladen wird. Informationen werden dann in der Sprache angezeigt, die Sie festlegen.

Der language-Parameter wirkt sich auf die Namen der Steuerelemente, Urheberrechtshinweise, Wegbeschreibungen und Steuerlabels sowie auf die Antworten auf Dienstanfragen aus. Wie sich der Parameter auf die Dienste selbst auswirkt, ist etwas komplexer. Beim Geocoding von Adressen auf Straßenebene wird z. B. der Name des Landes in der festgelegten Sprache zurückgegeben, der Rest der Adresse bleibt aber in der Sprache des entsprechenden Standorts. Ergebnisse mit Bezug auf Postleitzahlen sowie politische Ergebnisse werden hingegen in der festgelegten Sprache ausgegeben. Wie sich Änderungen am language-Parameter auf die Karte auswirken, können Sie in dieser Demo ausprobieren.

Im folgenden Beispiel wird eine Karte in japanischer Sprache angezeigt und Japan als Region festgelegt:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=JP&language=ja&callback=initMap">
</script>

Beispiel ansehen

Wenn Sie die Sprache der Karte definieren, muss auch die Region festgelegt werden. So lässt sich sicherstellen, dass Ihre Anwendung den vor Ort geltenden gesetzlichen Vorgaben entspricht.

Hinweis: Wenn die API wie oben gezeigt geladen wird, wird für die Karte für alle Nutzer Japanisch verwendet, unabhängig von ihren Browsereinstellungen. Bevor Sie diese Option festlegen, sollten Sie sich daher sicher sein, dass dieses Verhalten gewünscht ist.

Die Google Maps JavaScript API unterstützt auch bidirektionalen Text (Bidi), also Text mit zwei Schreibrichtungen – von links nach rechts (Left-to-Right, LTR) und von rechts nach links (Right-to-Left, RTL). Zu den RTL-Sprachen gehören Arabisch, Hebräisch und Persisch. Im Allgemeinen sollten Sie bei Seiten mit RTL-Sprachen für eine korrekte Darstellung sorgen, indem Sie dir='rtl' in das <html>-Element der Seite einfügen. Im folgenden Beispiel wird eine Karte von Kairo, Ägypten, mit arabischen Steuerelementen angezeigt:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=EG&language=ar&callback=initMap">
</script>

Beispiel ansehen

Eine Liste der unterstützten Sprachen finden Sie hier. In die Liste werden regelmäßig neue Sprachen aufgenommen, sodass sie unter Umständen nicht vollständig ist.

Regionslokalisierung

Wenn Sie Ihre Anwendung so ändern möchten, dass unterschiedliche Kartenkacheln geladen werden, oder wenn Sie eine Gewichtung vornehmen möchten und z. B. Geocoding-Ergebnisse einer bestimmten Region bevorzugt werden sollen, müssen Sie in das <script>-Tag einen region-Parameter einfügen, der mit dem Code der Maps JavaScript API geladen wird.

Da viele Dienste, z. B. Place Autocomplete, tendenziell bessere Ergebnisse liefern, wenn region konfiguriert ist, sollten Sie als Entwickler einer Maps JavaScript API-Anwendung immer einen region-Parameter festlegen. Außerdem müssen Sie sicherstellen, dass Ihre Anwendung lokalen Gesetzen entspricht. Dazu muss die korrekte Regionslokalisierung für das Land verwendet werden, in dem die Anwendung gehostet wird.

Für den region-Parameter sind untergeordnete Unicode-Tags als Kennungen für Regionen zulässig. Diese haben in der Regel jeweils genau eine Entsprechung innerhalb der länderspezifischen Top-Level-Domains (country code top-level domains, ccTLDs). Die meisten Unicode-Kennungen für Regionen entsprechen den Alpha-2-Codes nach ISO 3166. Es gibt jedoch einige Ausnahmen. So lautet beispielsweise die ccTLD des Vereinigten Königreichs „uk“ und die entsprechende Domain .co.uk, die Regionskennung dagegen „GB“. Welche Regionen unterstützt werden, sehen Sie in den Details zur Google Maps Platform-Abdeckung. Wie sich Änderungen am region-Parameter auf die Karte auswirken, können Sie in dieser Demoausprobieren.

Beispielsweise wird durch das folgende Skript-Tag die Karte für die Königreich:

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

Die folgenden Beispiele zeigen zwei Karten. In der einen ist region auf US (USA) gesetzt und „Toledo“ wird als „Toledo, Ohio“ geocodiert. In der anderen ist region auf ES (Spanien) gesetzt. Hier wird „Toledo, Spanien“ als Ergebnis ausgegeben.

Beispiel mit USA als Region und Beispiel mit Spanien als Region

Demo für die Lokalisierung

Wenn Sie die Sprache der Karte definieren, muss unbedingt auch die Region festgelegt werden. In dieser Demo wird gezeigt, wie Sie die Karte mit Ihren Einstellungen für Sprache und Region laden.

Sehen Sie sich diese Demo im Vollbildmodus an.