Lokalizacja mapy

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

  • zmienić domyślne ustawienia języka;
  • Określ kod regionu, który zmienia działanie mapy w zależności od danego kraju lub terytorium.

Lokalizacja językowa

Domyślnie interfejs Maps JavaScript API używa preferowanego ustawienia języka użytkownika określonego w przeglądarce podczas wyświetlania informacji tekstowych, takich jak nazwy elementów sterujących, powiadomienia o prawach autorskich, wskazówki dojazdu i etykiety na mapach. W większości przypadków lepiej jest uwzględniać ustawienia przeglądarki. Jeśli jednak chcesz, aby interfejs Maps JavaScript API ignorował ustawienia 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 interfejsu Maps JavaScript API.

Parametr language wpływa na nazwy elementów sterujących, informacje o prawach autorskich, wskazówki dojazdu i etykiety elementów sterujących, a także na odpowiedzi na zapytania o usługę. Wpływ na usługi nie jest tak oczywisty. Na przykład podczas geokodowania adresów na poziomie ulicy nazwa kraju jest zwracana w wybranym języku, ale reszta adresu będzie specyficzna dla geokodowanej lokalizacji. Z drugiej strony wyniki dotyczące poczty i polityki są zwracane w języku, w którym zostało wysłane żądanie. Wypróbuj demo lokalizacji, aby sprawdzić, jak zmiany w parametrze language wpływają na mapę.

W tym przykładzie mapa jest wyświetlana w języku japońskim, a region jest ustawiony 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ż ustawić region. Dzięki temu Twoja aplikacja będzie zgodna z lokalnymi przepisami.

Uwaga: gdy załadujesz interfejs API w sposób pokazany powyżej, mapa będzie używać języka japońskiego dla wszystkich użytkowników niezależnie od ich preferencji. Zanim ustawisz tę opcję, upewnij się, że chcesz, aby tak się działo.

Interfejs Maps JavaScript API natywnie obsługuje też tekst dwukierunkowy (Bidi) zawierający znaki w językach zapisywanych od lewej do prawej (LTR) i od prawej do lewej (RTL). Przykłady języków zapisywanych od prawej do lewej to arabski, hebrajski i perski. Ogólnie rzecz biorąc, aby strony w językach zapisywanych od prawej do lewej były prawidłowo renderowane, należy dodać atrybut dir='rtl' do elementu <html> na stronie. Poniższy przykład renderuje mapę Kairu w Egipcie z użyciem elementów sterujących w języku arabskim:

<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

Obsługiwane języki

Google często aktualizuje listę obsługiwanych języków. Ta lista może nie być wyczerpująca i może ulec zmianie.

Kod języka Język Kod języka Język
af afrikaans ja japoński
sq albański kn kannada
am amharski kk kazachski
ar arabski km khmerski
hy ormiański ko koreański
az azerski ky kirgiski
eu baskijski lo laotański
be białoruski lv łotewski
bn bengalski lt litewski
bs bośniacki mk macedoński
bg bułgarski ms malajski
my birmański ml malajalam
ca kataloński mr marathi
zh chiński mn mongolski
zh-CN chiński (uproszczony) ne nepalski
zh-HK chiński (Hongkong) nie norweski
zh-TW chiński (tradycyjny) pl polski
godz. chorwacki pt portugalski
cs czeski pt-BR portugalski (Brazylia)
da duński pt-PT portugalski (Portugalia)
nl niderlandzki pa pendżabski
en angielski ro rumuński
en-AU angielski (Australia) ru rosyjski
en-GB angielski (Wielka Brytania) sr serbski (cyrylica)
et estoński sr-Latn serbski (alfabet łaciński),
fa perski si syngaleski
fi fiński sk słowacki
fil filipiński sl słoweński
fr francuski es hiszpański
fr-CA francuski (Kanada) es-419 hiszpański (Ameryka Łacińska)
gl galicyjski sw suahili
ka gruziński sv szwedzki
de niemiecki ta tamilski
el grecki te telugu
gu gudżarati th tajski
iw hebrajski tr turecki
hi hindi uk ukraiński
hu węgierski ur urdu
jest islandzki uz uzbecki
id indonezyjski vi wietnamski
it włoski zu zulu

Lokalizacja regionalna

Podczas wczytywania kodu interfejsu Maps JavaScript API dodaj parametr region do tagu <script>, jeśli chcesz zmodyfikować aplikację, aby wyświetlała różne kafelki mapy lub aby była ukierunkowana (np. aby wyniki geokodowania były ukierunkowane na region).

Jako deweloper aplikacji korzystającej z interfejsu Maps JavaScript API powinieneś zawsze ustawiać parametr region, ponieważ różne usługi (np. autouzupełnianie miejsc) zwykle zapewniają lepsze wyniki, gdy ten parametr region jest ustawiony. Twoim obowiązkiem jest również dopilnowanie, aby aplikacja była zgodna z lokalnymi przepisami. W tym celu musisz zadbać o to, aby w kraju, w którym jest hostowana, była stosowana odpowiednia lokalizacja regionalna.

Parametr region akceptuje identyfikatory podtagów regionu Unicode, które (zwykle) mają mapowanie 1:1 na krajowe domeny 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” (odpowiadający domenie .co.uk), a identyfikator regionu to „GB”. Listę obsługiwanych regionów znajdziesz w artykule Szczegóły zasięgu Google Maps Platform. Wypróbuj tę wersję demonstracyjną, aby sprawdzić, jak zmienia się mapa po zaktualizowaniu parametru region.

Na przykład ten tag skryptu lokalizuje mapę w Wielkiej Brytanii:

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

Poniższe przykłady pokazują 2 mapy. Pierwsza z nich geokoduje „Toledo” na podstawie parametru region ustawionego na US (Stany Zjednoczone) jako „Toledo, Ohio”, a druga – na podstawie parametru region ustawionego na ES (Hiszpania) jako „Toledo, Hiszpania”.

Zobacz przykład dotyczący Stanów Zjednoczonych i przykład dotyczący Hiszpanii.

Wersja demonstracyjna lokalizacji

Ustawiając język mapy, warto też określić region. Tutaj znajdziesz wersję demonstracyjną, która umożliwia wczytanie mapy w wybranym języku i regionie.

Wyświetl tę prezentację na pełnym ekranie.