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 ustawienia języka określonego przez przeglądarkę podczas wyświetlania informacji tekstowych, takich jak nazwy elementów sterujących, informacje o prawach autorskich, wskazówki dojazdu i etykiety na mapach. W większości przypadków najlepiej jest przestrzegać ustawienia przeglądarki. Jeśli jednak chcesz, aby interfejs JavaScript JavaScript Map Google ignorował ustawienie języka przeglądarki, możesz wymusić wyświetlanie informacji w określonym języku. Aby to zrobić, dodaj parametr language do tagu <script> podczas wczytywania kodu interfejsu API JavaScriptu Map.

Parametr language wpływa na nazwy elementów sterujących, powiadomienia o prawach autorskich, wskazówki dojazdu i etykiety, a także odpowiedzi na żądania usługi. Wpływ na usługi nie jest tak oczywisty. Na przykład gdy w przypadku adresów geograficznych na poziomie ulicy adres kraju będzie zwracany w wybranym przez Ciebie języku, a pozostały adres zostanie zakodowany w danej lokalizacji. Z kolei wyniki pocztowe i polityczne są zwracane w wybranym języku. Wypróbuj tę wersję demonstracyjną, aby przetestować zmiany 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 ustawisz język mapy, pamiętaj też o ustawieniu regionu. Dzięki temu będziesz mieć pewność, że Twoja aplikacja jest zgodna z lokalnymi przepisami.

Uwaga: po załadowaniu interfejsu API w sposób opisany powyżej na mapie zostanie użyty język japoński dla wszystkich użytkowników, niezależnie od preferencji użytkownika. Zanim skonfigurujesz tę opcję, upewnij się, że chcesz używać tego ustawienia.

Interfejs Maps JavaScript API obsługuje też natywnie tekst dwukierunkowy (Bidi) w językach zapisywanych od lewej do prawej (LTR) oraz od prawej do lewej (RTL). Przykłady języków RTL to arabski, hebrajski i farsi. Aby prawidłowo wyrenderować strony w języku RTL, dodaj do elementu <html> element dir='rtl'. Poniższy przykład przedstawia mapę Kairu w Egipcie z użyciem 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. 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 JavaScript JavaScript Maps, jeśli chcesz zmienić aplikację tak, aby wyświetlać różne kafelki mapy lub stronniczo

Dlatego zachęcamy do ustawienia parametru region Maps API API, ponieważ różne usługi (takie jak autouzupełnianie miejsc) dostarczają zwykle lepsze wyniki po ustawieniu region. Twoim obowiązkiem jest też dopilnowanie, żeby Twoja aplikacja była zgodna z przepisami obowiązującymi w danym kraju. W takim przypadku musisz mieć pewność, że aplikacja jest hostowana w kraju, w którym jest hostowana.

Parametr region akceptuje identyfikatory tagów podrzędnych regionu Unicode, które (zazwyczaj) mają zmapowane na kraj krajowe domeny najwyższego poziomu (ccTLD). Większość identyfikatorów regionów Unicode jest taka sama jak kody ISO 3166-1 alfa-2, ale istnieją pewne wyjątki. Na przykład Wielka Brytania to „"uk&quot” (odpowiada domenie .co.uk), a jej identyfikatorem regionu jest „"GB”." Aby dowiedzieć się, które regiony są obsługiwane, zobacz Szczegóły zasięgu w Google Maps Platform. Wypróbuj tę wersję demonstracyjną, aby przetestować zmiany na mapie po zaktualizowaniu parametru region.

Na przykład ten tag skryptu tłumaczy lokalizację na Wielką Brytanię:

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

W poniższych przykładach widać 2 mapy: jedną z kodami geograficznymi &Totdo; na podstawie region z wartością US ustawioną na US (USA) oraz „Toledo”, z Ohio" drugą z odchyleniami na podstawie wartości region ustawionymi na ES (Hiszpania) i „Toledo, Hiszpania”."

Zapoznaj się z przykładem z USA i przykładem z ES.

Wersja demonstracyjna lokalizacji

Ustalając język mapy, warto rozważyć ustawienie regionu. Oto wersja demonstracyjna, dzięki której możesz załadować mapę do wybranego języka i regionu.

Obejrzyj wersję demonstracyjną na pełnym ekranie.