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, informacje 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ł 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 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 żądania 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 zapytanie. Wypróbuj tę wersję demonstracyjną, aby sprawdzić, jak zmienia się mapa 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&region=JP&language=ja&callback=initMap">
</script>

Zobacz przykład

Jeśli ustawisz język mapy, warto też ustawić region. Dzięki temu możesz mieć pewność, że Twoja aplikacja jest zgodna z lokalnymi przepisami prawa.

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

Interfejs Maps JavaScript API obsługuje też dwukierunkowy tekst zawierający znaki w językach zapisywanych od lewej do prawej i od prawej do lewej. 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

Zobacz listę obsługiwanych języków. Pamiętaj, że często dodajemy nowe języki, więc ta lista może być niekompletna.

Lokalizacja regionalna

Jeśli chcesz zmodyfikować aplikację, aby udostępniała różne fragmenty mapy lub aby była ona ukierunkowana (np. wyniki geokodowania były ukierunkowane na region), dodaj parametr region do tagu <script> podczas wczytywania kodu interfejsu Maps JavaScript API.

Jako deweloper aplikacji korzystającej z interfejsu Maps JavaScript API zawsze ustawiaj parametr region, ponieważ różne usługi (np. autouzupełnianie miejsc) zwykle zapewniają lepsze wyniki, gdy parametr region jest ustawiony. Twoim obowiązkiem jest również dopilnowanie, aby aplikacja była zgodna z lokalnymi przepisami prawa. 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 szczegółach 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

Podczas ustawiania języka mapy warto też ustawić 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.