지도 현지화

기본 언어 설정과 지도 지역 코드를 변경하여 지도에 사용되는 언어 및 지역 설정을 맞춤설정할 수 있습니다. 지도 지역 코드는 지정된 국가 또는 지역을 기반으로 지도의 동작에 영향을 줄 수 있습니다.

지도 지원 범위 표 에서 Android용 지도 3D SDK의 지원 범위를 확인하세요.

언어 현지화

기본적으로 Android용 지도 3D SDK는 사용자의 기기에 구성된 언어 설정을 사용하여 표시할 지도의 번역을 결정합니다. 하지만 이 기본 동작을 재정의하고 지도를 초기화할 때 특정 언어를 설정하거나 지도가 초기화된 후 언어와 지역을 동적으로 업데이트할 수 있습니다.

언어를 설정하면 UI 컨트롤, 툴팁, 저작권 고지가 표시되는 언어에 영향을 미칩니다. 런타임 언어 업데이트는 지도 뷰에 반영되지만 다른 UI 컨트롤, 툴팁 또는 기타 요소에는 반영되지 않습니다. 또한 정치적 특징, 설명자, 자연적 특징(예: 'Geneva'를 'Genève'로 또는 'lake'를 'lac'로 변경)의 번역에 영향을 미치고 오른쪽에서 왼쪽으로 쓰는 스크립트의 텍스트가 렌더링되는 방향을 변경합니다.

Android용 지도 3D SDK는 다음 순서로 현지화 환경설정을 찾습니다. 첫 번째 단계에서 환경설정이 정의되지 않은 경우 지정된 순서로 계속 찾습니다.

  1. 런타임 업데이트: setLocale 를 사용하여 GoogleMap3D 인스턴스의 LocaleOptions에 전달된 언어 및 지역 환경설정입니다.
  2. 지도 초기화: Map3DView에서 레이아웃 XML의 map3d:language 및 map3d:region 속성을 사용하거나 Map3DInitConfig를 사용하여 프로그래매틱 방식으로 지도를 만들 때 지정된 언어 및 지역 환경설정입니다.
  3. 기기 설정: Android 기기에 구성된 시스템 기본 언어입니다.

다음 예에서는 중국어 ("zh")로 지도를 표시하고 지역을 중국 ("CN")으로 설정합니다.

레이아웃 XML 파일에서 map3d:language 및 map3d:region 속성을 사용하여 언어와 지역을 구성할 수 있습니다 Map3DView.

<com.google.android.gms.maps3d.Map3DView
    android:id="@+id/map3dView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    map3d:mapMode="hybrid"
    map3d:language="zh"
    map3d:region="CN" />

` LocaleOptions ` 인스턴스를 만들고 ` setLanguage ` 및 ` setRegion `으로 값을 설정한 후 ` GoogleMap3D ` 인스턴스의 ` setLocale `에 전달하여 런타임에 언어와 지역을 동적으로 업데이트할 수도 있습니다.

val localeOptions = LocaleOptions().apply {
    language = "zh"
    region = "CN"
}
googleMap3D.setLocale(localeOptions)

지역 현지화

map3d:region XML 속성, region 의 Map3DInitConfig, 속성 또는 setRegion 의 LocaleOptions 을 사용하여 지역을 설정하면 다양한 지도 타일을 제공하거나 애플리케이션을 지역에 더 적합한 결과로 편향시킬 수 있습니다. 또한 지역 태그를 설정하면 애플리케이션이 배포되는 국가 또는 지역에 올바른 지역 현지화를 적용하여 애플리케이션이 현지 법률을 준수하도록 할 수 있습니다.