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®ion=JP&language=ja&callback=initMap">
</script>
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®ion=EG&language=ar&callback=initMap">
</script>
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®ion=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.