Lokalizowanie mapy

Możesz dostosować mapę dla określonego kraju lub regionu na następujące sposoby:

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

Lokalizacja języka

Do wyświetlania informacji tekstowych, takich jak nazwy elementów sterujących, informacje o prawach autorskich, wskazówki dojazdu i etykiety na mapach, domyślnie interfejs Maps JavaScript API używa preferowanego przez użytkownika ustawienia języka, które jest określone w przeglądarce. W większości przypadków warto uwzględniać ustawienie przeglądarki. Jeśli jednak chcesz, aby interfejs Maps JavaScript API ignorował ustawienie języka w przeglądarce, możesz wymusić wyświetlanie informacji w konkretnym języku, dodając parametr language do tagu <script> podczas wczytywania kodu JavaScript API Map Google.

Parametr language wpływa na nazwy elementów sterujących, informacji o prawach autorskich, wskazówek dojazdu i etykiet kontrolnych, a także na odpowiedzi na prośby o usługę. Wpływ na usługi nie jest tak widoczny. Na przykład przy geokodowaniu adresów na poziomie ulicy nazwa kraju jest zwracana w żądanym języku, ale reszta adresu jest związana z lokalizacją pod kątem geokodowania. Z kolei wyniki pocztowe i polityczne są zwracane w żądanym języku. Przeprowadź tę prezentację, aby poeksperymentować ze zmianami na mapie po zaktualizowaniu parametru language.

Ten przykład wyświetla mapę 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ż rozważyć ustawienie regionu. Dzięki temu będziemy mieć pewność, że Twoja aplikacja jest zgodna z przepisami obowiązującymi w danym kraju.

Uwaga: jeśli wczytujesz interfejs API w sposób pokazany powyżej, mapa jest wyświetlana w języku japońskim dla wszystkich użytkowników, niezależnie od ich preferencji. Zanim ustawisz tę opcję, upewnij się, że chcesz jej użyć w ten sposób.

Maps JavaScript API obsługuje też natywnie tekst dwukierunkowy (Bidi) zawierający znaki zarówno w językach z zapisem od lewej do prawej, jak i od prawej do lewej (RTL). Przykłady języków z zapisem od prawej do lewej to arabski, hebrajski i perski. Ogólnie strony w języku RTL powinny być prawidłowo renderowane, dodając tag dir='rtl' do elementu <html> strony. Ten przykład renderuje mapę Kairu w Egipcie przy użyciu arabskich elementów sterujących:

<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. Często dodajemy nowe języki, więc ta lista może nie być pełna.

Lokalizacja regionu

Dodaj parametr region do tagu <script> podczas wczytywania kodu Maps JavaScript API, jeśli chcesz zmienić aplikację w taki sposób, aby wyświetlała inne fragmenty mapy, lub ją zniechęcić (na przykład przez promowanie wyników geokodowania w kierunku regionu).

Deweloperzy aplikacji Maps JavaScript API powinni zawsze ustawiać parametr region, ponieważ różne usługi (np. autouzupełnianie miejsc) dają zwykle lepsze wyniki, gdy jest ustawiony parametr region. Twoim obowiązkiem jest też dopilnowanie, by aplikacja była zgodna z lokalnymi przepisami prawa przez zastosowanie prawidłowej lokalizacji dla kraju, w którym jest ona hostowana.

Parametr region akceptuje identyfikatory subtagów regionu Unicode, które (zwykle) mają mapowanie 1:1 na domeny najwyższego poziomu z kodem kraju (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 domena ccTLD w Wielkiej Brytanii to „uk” (odpowiada domenie .co.uk), a jej identyfikator regionu to „GB”. Sprawdź szczegóły zasięgu Google Maps Platform, aby zobaczyć obsługiwane regiony. Przeprowadź tę prezentację, aby poeksperymentować ze zmianami na mapie po zaktualizowaniu parametru region.

Na przykład ten tag skryptu pozwala zlokalizować 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 pokazujemy 2 mapy. Jedna z map, których geokodem to „Toledo” na podstawie pola region ustawionego na US (Stany Zjednoczone) jako „Toledo, Ohio”, i drugiej, która uporządkuje wyniki na podstawie pola region z ustawieniem ES (Hiszpania) na „Toledo, Hiszpania”.

Wyświetl przykład ze Stanów Zjednoczonych i przykład ES.

Wersja demonstracyjna lokalizacji

Ustawiając język mapy, należy również wziąć pod uwagę ustawienia regionu. Oto wersja demonstracyjna, która umożliwia wczytanie mapy w wybranym języku i regionie.

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