Configurar um projeto existente do Android Studio

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

  1. O Android Studio é obrigatório. Faça o download e instale esse ambiente de desenvolvimento integrado, caso ainda não tenha feito isso.

  2. 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:

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ê precisará 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:18.0.0'
    // ...
}

Próximas etapas

Depois de configurar o projeto, você poderá adicionar um mapa.