Esta página descreve como configurar um projeto do Android Studio para usar o SDK do Maps para Android sem o modelo do Google Maps detalhado no guia de início rápido.
O modelo do Google Maps configura e adiciona automaticamente um mapa básico a um novo projeto do Android Studio. No entanto, você também pode adicionar um mapa a um projeto Android com um modelo diferente do Android Studio. Para fazer isso, é preciso configurar manualmente seu projeto e, depois, adicionar o mapa.
Configurar o Android Studio
O Android Studio é obrigatório. Faça o download e instale esse ambiente de desenvolvimento integrado, caso ainda não tenha feito isso.
Adicione o SDK do Google Play Services ao Android Studio. O SDK do Maps para Android é distribuído como parte do SDK do Google Play Services, que você pode adicionar usando o SDK Manager.
Configurar uma chave de API e um projeto do Cloud
Para configurar uma chave de API e um projeto do Cloud, faça o seguinte:
Siga as instruções do guia Como configurar no Console do Google Cloud para criar um projeto do Cloud com faturamento ativado e habilitar o SDK do Maps para Android.
Siga as instruções do guia Como usar a chave de API para criar sua chave e adicioná-la ao app.
Atualizar o manifesto do app
Esta seção fala sobre as configurações que você pode adicionar no seu arquivo AndroidManifest.xml.
Número da versão do Google Play Services
Inclua a seguinte declaração no elemento application. Isso incorpora a versão do Google Play Services com que o app foi compilado.
<meta-data
android:name="com.google.android.gms.version"
android:value="@integer/google_play_services_version" />
Permissão de localização
Caso o app tenha que acessar a localização do usuário, você precisa solicitar a permissão no arquivo AndroidManifest.xml. As opções são ACCESS_FINE_LOCATION, que fornece a localização exata do usuário, e ACCESS_COARSE_LOCATION, que tem uma precisão menor. Para saber mais detalhes, consulte o guia de dados de localização.
Para solicitar a permissão do ACCESS_FINE_LOCATION, adicione este código ao elemento manifest:
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
Permissão de armazenamento externo
Se você segmentar a versão 8.3 ou mais recente do SDK do Google Play Services, a permissão WRITE_EXTERNAL_STORAGE deixa de ser necessária. Caso segmente versões anteriores do SDK do Google Play Services, será preciso solicitar a permissão WRITE_EXTERNAL_STORAGE no elemento manifest.
<uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
Biblioteca legada Apache HTTP
Se você estiver usando a com.google.android.gms:play-services-maps:16.0.0 ou versões anteriores e seu app segmentar o nível da API 28 (Android 9.0) ou superior, será necessário incluir a seguinte declaração no elemento <application> do AndroidManifest.xml. Caso contrário, pule esta declaração.
<uses-library
android:name="org.apache.http.legacy"
android:required="false" />
Adicionar a dependência do Maps
No arquivo build.gradle no nível do app, adicione a dependência do Maps. Para mais detalhes, consulte o guia de controle de versões.
dependencies {
implementation 'com.google.android.gms:play-services-maps:17.0.1'
// ...
}
Próximas etapas
Depois de configurar o projeto, você poderá adicionar um mapa.