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