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 obszaru.

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 oznaczenia na mapach. W większości przypadków lepiej jest zachować ustawienia przeglądarki. Jeśli jednak chcesz, aby interfejs Maps JavaScript API ignorował ustawienie języka w przeglądarce, możesz zmusić go do wyświetlania 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, powiadomienia o prawach autorskich, wskazówki dojazdu i etykiety elementów sterujących, a także odpowiedzi na żądania usługi. 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 odpowiadać lokalizacji, którą geokodujesz. Z drugiej strony wyniki dotyczące poczty i polityki są zwracane w wymaganym języku. Wypróbuj to demo, aby eksperymentować z zmianami na mapie po zaktualizowaniu parametru language.

Ten przykład przedstawia mapę w języku japońskim z regionem ustawionym 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 ustawiasz język mapy, warto też ustawić region. Dzięki temu aplikacja będzie zgodna z lokalnymi przepisami.

Uwaga: gdy wczytasz interfejs API w sposób pokazany powyżej, mapa 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 było.

Interfejs Maps JavaScript API obsługuje też tekst dwukierunkowy (Bidi) zawierający znaki w językach zarówno zapisywanych od lewej do prawej, jak i od prawej do lewej. Przykłady języków z zapisem od prawej do lewej: arabski, hebrajski i perski. Zazwyczaj należy określić strony w językach z orientacją poziomą, aby poprawnie je renderować. W tym celu należy dodać element dir='rtl' do elementu <html> strony. W tym przykładzie renderujemy mapę Kairu w Egipcie, używając 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 nowe języki są często dodawane, więc ta lista może być niekompletna.

Lokalizacja regionalna

Jeśli chcesz zmienić aplikację, aby wyświetlała różne kafelki mapy lub zniekształcać wyniki, dodaj parametr region do tagu <script> podczas wczytywania kodu interfejsu Maps JavaScript API (np. zniekształcanie wyników geokodowania w danym regionie).

Jako deweloper aplikacji Map JavaScript API zachęcamy do zawsze ustawiania parametru region, ponieważ różne usługi (np. autouzupełnianie miejsc) zwykle dają lepsze wyniki, gdy parametr region jest ustawiony. Twoim obowiązkiem jest też dopilnowanie, aby aplikacja była zgodna z lokalnymi przepisami. Aby to osiągnąć, zastosuj prawidłową lokalizację regionalną dla kraju, w którym znajduje się serwer aplikacji.

Parametr region akceptuje identyfikatory podtagów regionów w standardzie Unicode, które (zwykle) są mapowane 1:1 na domeny krajowe najwyższego poziomu (ccTLD). Większość identyfikatorów regionów w standardzie Unicode jest identyczna z kodami ISO 3166-1 alfa-2, z niektórymi wyjątkami. Na przykład kod kraju i domeny najwyższego poziomu Wielkiej Brytanii to „uk” (odpowiadający domenie .co.uk), a identyfikator regionu to „GB”. Zapoznaj się ze szczegółami dotyczącymi dostępności Google Maps Platform w obsługiwanych regionach. Wypróbuj to demo, aby eksperymentować z zmianami na mapie po zaktualizowaniu parametru region.

Na przykład ten tag skryptu umożliwia zlokalizowanie mapy na potrzeby 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 geokodem „Toledo” na podstawie region ustawionego na US (USA) jako „Toledo, Ohio” i druga z wynikiem opartym na region ustawionym na ES (Hiszpania) jako „Toledo, Hiszpania”.

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

Lokalizacja – wersja demonstracyjna

Podczas ustawiania języka mapy warto też wziąć pod uwagę region. Oto wersja demonstracyjna, która umożliwia załadowanie mapy z wybranym językiem i regionem.

Wyświetl tę prezentację w trybie pełnoekranowym.