Zlokalizuj mapę

Możesz dostosować mapę dla konkretnego kraju lub regionu na te sposoby:

  • Zmień ustawienia domyślnego języka.
  • Określ kod regionu, który zmienia działanie mapy w zależności od kraju lub terytorium.

Lokalizacja językowa

Domyślnie Maps JavaScript API wyświetla informacje tekstowe, takie jak nazwy elementów sterujących, informacje o prawach autorskich, wskazówki dojazdu i etykiety na mapach, korzystając z preferowanego ustawienia języka użytkownika określonego w przeglądarce. W większości przypadków lepiej jest przestrzegać ustawień przeglądarki. Jeśli jednak chcesz, aby interfejs Maps JavaScript API ignorował ustawienie języka przeglądarki, możesz wymusić wyświetlanie informacji w określonym języku, dodając parametr language do tagu <script> podczas wczytywania kodu Maps JavaScript API.

Parametr language wpływa na nazwy elementów sterujących, informacje o prawach autorskich, wskazówki dojazdu i etykiety sterujące, a także odpowiedzi na żądania usługi. Wpływ na usługi nie jest tak widoczny. Jeśli na przykład geokodowanie adresu na poziomie ulicy będzie wskazywać, że nazwa kraju będzie wyświetlana w wybranym przez Ciebie języku, a reszta adresu będzie uzależniona od lokalizacji objętej geokodowaniem. Z drugiej strony wyniki pocztowe i polityczne są zwracane w wybranym języku. Wypróbuj tę demonstrację, aby poeksperymentować ze zmianami na mapie podczas aktualizowania parametru language.

W poniższym przykładzie wyświetlana jest mapa w języku japońskim i ustawia region na Japonię:

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

Zobacz przykład

Jeśli ustawisz język mapy, warto też ustawić region. Dzięki temu będziesz mieć pewność, że Twoja aplikacja jest zgodna z lokalnymi przepisami.

Uwaga: gdy wczytujesz interfejs API w sposób opisany powyżej, wszyscy użytkownicy korzystają z mapy w języku japońskim, niezależnie od ich preferencji. Zanim ustawisz tę opcję, upewnij się, że chcesz korzystać z takiego działania.

Interfejs Maps JavaScript API obsługuje również tekst dwukierunkowy (Bidi) zawierający znaki zarówno w językach pisanych od lewej do prawej, jak i od prawej do lewej (RTL). Przykłady języków RTL to arabski, hebrajski i farsi. Aby strony w języku RTL były prawidłowo renderowane, zwykle musisz dodać dir='rtl' do ich elementu <html>. Ten przykład renderuje mapę Kairu w Egipcie z użyciem ustawień arabskich:

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

Zobacz przykład

Zobacz listę obsługiwanych języków. Pamiętaj, że często dodajemy nowe języki, więc ta lista może nie być wyczerpująca.

Lokalizacja regionu

Dodaj parametr region do tagu <script> podczas wczytywania kodu interfejsu Maps JavaScript API, jeśli chcesz zmodyfikować swoją aplikację tak, aby wyświetlała różne fragmenty mapy lub kierowała aplikację (np. geokodowanie w kierunku regionu).

Zachęcamy twórców aplikacji Maps JavaScript API do ustawiania parametru region, ponieważ różne usługi (np. autouzupełnianie miejsc) dają zwykle lepsze wyniki, gdy jest ustawiony parametr region. Odpowiadasz także za zapewnienie zgodności aplikacji z przepisami obowiązującymi w danym kraju poprzez zadbanie o właściwą lokalizację regionu w przypadku kraju, w którym aplikacja jest hostowana.

Parametr region akceptuje identyfikatory subtagu regionu Unicode, które (zazwyczaj) mają mapowanie jeden do jednego na krajowe domeny najwyższego poziomu (ccTLD). Większość identyfikatorów regionów Unicode jest taka sama jak kody ISO 3166-1 alfa-2 z kilkoma istotnymi wyjątkami. Na przykład brytyjska domena ccTLDs to „uk” (odpowiada domenie .co.uk), a jej identyfikator regionu to „GB”. Sprawdź szczegóły zasięgu Google Maps Platform w obsługiwanych regionach. Wypróbuj tę demonstrację, aby poeksperymentować ze zmianami na mapie podczas aktualizowania parametru region.

Na przykład ten tag skryptu lokalizuje mapę na Wielką Brytanię:

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

W poniższych przykładach znajdują się 2 mapy. Jedna z nich określa kod geograficzny „Toledo” na podstawie pola region ustawionego jako US (USA) na „Toledo, Ohio”, a drugiej określa odchylenia wyników na podstawie pola region ustawionego jako ES (Hiszpania) na „Toledo, Hiszpania”.

Wyświetl przykład w Stanach Zjednoczonych i przykład z ES.

Wersja demonstracyjna lokalizacji

Podczas ustawiania języka mapy warto też ustawić region. Oto wersja demonstracyjna, która umożliwia wczytanie mapy w wybranym języku i regionie.

Wyświetl wersję demonstracyjną na pełnym ekranie.