Lokalizowanie mapy

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Mapę dla konkretnego kraju lub regionu możesz dostosować na te sposoby:

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

Lokalizacja języka

Domyślnie interfejs Maps JavaScript API korzysta z preferowanego przez użytkownika ustawienia języka wskazanego w przeglądarce, gdy wyświetlane są na mapie informacje takie jak nazwy elementów sterujących, informacji o prawach autorskich czy trasy dojazdu i etykiety. W większości przypadków najlepiej jest przestrzegać ustawienia przeglądarki. Jeśli jednak chcesz, aby interfejs JavaScript JavaScript API ignorował ustawienia języka przeglądarki, możesz wymusić jego wyświetlanie w określonym języku, dodając do tagu <script> parametr language podczas wczytywania kodu interfejsu API JavaScript Map Google.

Parametr language wpływa na nazwy elementów sterujących, powiadomienia o prawach autorskich, wskazówki dojazdu i etykiety elementów sterujących, a także na odpowiedzi na żądania usługi. Wpływ na usługi nie jest tak oczywisty. Na przykład gdy adresowanie geograficzne jest rozpoznawane na poziomie kraju w wybranym przez Ciebie języku, a reszta adresu zależy od lokalizacji geograficznej. Z drugiej strony wyniki wyszukiwania poczty i polityki są wyświetlane w wybranym języku. Wypróbuj wersję demonstracyjną, aby eksperymentować ze zmianami na mapie po zaktualizowaniu parametru language.

Poniższy przykład pokazuje 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&region=JP&language=ja&callback=initMap">
</script>

Zobacz przykład

Jeśli masz ustawiony język mapy, warto też ustawić region. Pomoże to zapewnić zgodność z lokalnymi przepisami.

Uwaga: po załadowaniu interfejsu API w sposób opisany powyżej mapa używa języka japońskiego dla wszystkich użytkowników niezależnie od ich preferencji. Przed ustawieniem tej opcji upewnij się, że chcesz, aby takie zachowanie było możliwe.

Interfejs Maps JavaScript API obsługuje natywnie tekst w języku dwukierunkowym (Bidi) oraz znaki od lewej do prawej (LTR) i od prawej do lewej (RTL). Przykłady języków RTL to arabski, hebrajski i farsi. Ogólnie strony w języku RTL powinny być renderowane prawidłowo, dodając tag dir='rtl' do elementu <html>. Poniższy przykład przedstawia mapę Kairu w Egipcie z wykorzystaniem arabskich elementów sterujących:

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

Zobacz przykład

Zobacz listę obsługiwanych języków. Pamiętaj, że nowe języki są często dodawane, więc ta lista może być niepełna.

Lokalizacja regionu

Dodaj parametr region do tagu <script> podczas wczytywania kodu interfejsu Maps JavaScript API, jeśli chcesz zmienić aplikację tak, aby wyświetlała inne kafelki mapy lub tendencyjność aplikacji (np. odchylanie wyników w geokodowaniu na poziomie regionu).

Jako deweloper aplikacji interfejsu Maps JavaScript API zalecamy zawsze ustawić parametr region, ponieważ różne usługi (takie jak autouzupełnianie miejsc) zwykle dają lepsze wyniki przy ustawieniu region. Musisz też dopilnować, aby Twoja aplikacja była zgodna z przepisami prawa w danym kraju.

Parametr region akceptuje identyfikatory subtagów regionu Unicode, które (zwykle) mają mapowanie typu „jeden do jednego” na kod kraju najwyższego poziomu (ccTLD). Większość identyfikatorów regionów Unicode jest identyczna z kodami ISO 3166-1 alfa-2, z kilkoma istotnymi wyjątkami. Na przykład ccTLD Wielkiej Brytanii to „uk” (odpowiada domenie .co.uk), a jej identyfikator regionu to „GB”. Listę obsługiwanych regionów znajdziesz w artykule dotyczącym pokrycia zasięgu Google Maps Platform. Wypróbuj wersję demonstracyjną, aby eksperymentować ze zmianami na mapie po zaktualizowaniu 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&region=GB&callback=initMap">
</script>

Te przykłady pokazują 2 mapy: jedną z kodem geograficznym „Toledo” na podstawie region ustawionego na US (USA) na „Toledo, Ohio”, a drugą na podstawie wyników region z ustawioną wartością ES (Hiszpania) na „Toledo, Hiszpania”.

Zobacz przykład ze Stanów Zjednoczonych i przykład z Hiszpanii.

Wersja demonstracyjna lokalizacji

Ustawiając język mapy, należy również uwzględnić region. Oto wersja demonstracyjna, która umożliwia ładowanie mapy w wybranym języku i regionie.

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