Localizar o mapa

Para personalizar as configurações de idioma e região usadas no mapa, mude as configurações de idioma padrão e o código de região do mapa, o que pode afetar o comportamento do mapa com base no país ou território especificado.

Consulte a cobertura do SDK do Maps 3D para Android na tabela de cobertura do Maps.

Localização de idioma

Por padrão, o SDK do Maps 3D para Android usa as configurações de idioma configuradas no dispositivo do usuário para determinar qual tradução do mapa mostrar. No entanto, é possível substituir esse comportamento padrão e definir um idioma específico ao inicializar o mapa ou atualizar o idioma e a região de forma dinâmica após a inicialização do mapa.

A definição do idioma afeta o idioma em que os controles da interface, as dicas de ferramentas e os avisos de direitos autorais são mostrados. As atualizações de localidade do ambiente de execução são refletidas na visualização do mapa, mas não em nenhum dos outros controles da interface, dicas de ferramentas ou outros elementos. Isso também afeta a tradução de recursos políticos, descritores e recursos naturais, como mudar "Geneva" para "Genève" ou "lake" para "lac", e muda a direção em que o texto é renderizado para scripts da direita para a esquerda.

O SDK do Maps 3D para Android procura preferências de localização na ordem a seguir. Se as preferências não forem definidas na primeira etapa, ele continuará procurando na ordem especificada:

1. Atualizações do ambiente de execução: preferências de idioma e região transmitidas para setLocale na instância GoogleMap3D usando LocaleOptions.
2. Inicialização do mapa: preferências de idioma e região especificadas ao criar o mapa, seja no XML de layout em Map3DView usando os atributos map3d:language e map3d:region, ou de forma programática usando Map3DInitConfig.
3. Configurações do dispositivo: a localidade padrão do sistema configurada no dispositivo Android

O exemplo a seguir mostra um mapa em chinês ("zh") e define a região como China ("CN").

Você pode configurar o idioma e a região no arquivo XML de layout usando os map3d:language e map3d:region atributos em 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" />

Também é possível atualizar o idioma e a região de forma dinâmica no ambiente de execução criando uma LocaleOptions instância, definindo os valores com setLanguage e setRegion, e transmitindo-a para setLocale na instância GoogleMap3D:

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

Localização de regiões

Definir a região usando o atributo XML map3d:region, a propriedade region em Map3DInitConfig, ou setRegion em LocaleOptions pode veicular blocos de mapa diferentes ou direcionar o aplicativo para resultados mais adequados à região. Além disso, definir a tag de região garante que o aplicativo obedeça às leis locais aplicando a localização regional correta para o país ou território em que o aplicativo é distribuído.