Projeto GoHome Tutorial Sobre o serviço do Google Maps no Android

Transcrição

1 Projeto GoHome Tutorial Sobre o serviço do Google Maps no Android Moisés Batista Bispo Teresina-PI

2 1- Breve Descrição Este tutorial tem como objetivo, adicionar de forma simples e prática, um mapa ao seu projeto Android. O Android Studio é o ambiente de desenvolvimento utilizado para este fim. 2- Requisitos e Orientações Para prosseguir, é necessário que já tenha baixado e instalado o Android Studio e o SDK do Google Play Services. Caso não tenha o Android, olhe primeiramente o tutorial que aborda esta intalação. 3- Criando o Projeto Google Maps - Inicie o Android Studio; - Crie um novo projeto;

3 - Insira o nome do aplicativo, o domínio da empresa e a localização do projeto, como solicitado. Clique em Next. - Selecione as especificações necessárias para o aplicativo. Se não tiver certeza do que é necessário, selecione Phone and Tablet. Clique em Next.

4 - Selecione Google Maps Activity no diálogo "Add an activity to Mobile". Clique em Next. - Insira o nome da atividade, o nome do layout e o título, conforme solicitado. Os valores padrão são adequados. Clique em Finish.

5 O Android Studio inicia o Gradle e cria o projeto. Isso pode demorar alguns segundos. Quando a criação é concluída, o Android Studio abre os arquivos google_maps_api.xml e MapsActivity.javano editor. (Os nomes dos arquivos dependem dos valores inseridos durante a configuração.) Observe que o arquivo google_maps_api.xml contém instruções para obter uma chave da Google Maps API antes de tentar executar o aplicativo. A seguir veremos em mais detalhes como obter a chave de API. 4- Obter uma Chave da Google Maps API O aplicativo precisa de uma chave de API para acessar os servidores do Google Maps. O tipo de chave necessário é uma chave para aplicativos Android. A chave é gratuita. Você pode usá-la com qualquer aplicativo que chama a Google Maps Android API. A chave permite um número ilimitado de usuários. Maneira Fácil e Rápida: - Copie o link fornecido no arquivo google_maps_api.xml e cole-o no navegador. O link acessa o Google Developers Console e fornece informações por meio de parâmetros de URL, minimizando os dados informados manualmente. - Siga as instruções para criar um novo projeto no console ou selecione um projeto existente.

6 - Crie uma chave da Android API para o projeto do console. - Copie a chave de API, volte ao Android Studio e cole-a no elemento <string> do arquivo google_maps_api.xml. Forma Alternativa e Mais Demorada - Copie as credenciais fornecidas no arquivo google_maps_api.xml. - Acesse o Google Developers Console no navegador. - Use as credenciais copiadas para adicionar o aplicativo a uma chave de API existente ou para criar uma nova chave de API. Para obter mais detalhes, consulte o processo completo.

7 5- Analisando o código O arquivo de layout XML: Por padrão, o arquivo XML que define o layout do aplicativo está em res/layout/activity_maps.xml. Esse arquivo contém o seguinte código: <fragment xmlns:android=" xmlns:tools=" android:layout_width="match_parent" android:layout_height="match_parent" android:id="@+id/map" tools:context=".mapsactivity" android:name="com.google.android.gms.maps.supportmapfragment" /> O arquivo Java de atividades de mapa: Por padrão, o arquivo Java que define a atividade dos mapas é denominado MapsActivity.java. Esse arquivo contém o seguinte código após o nome do pacote: import android.os.bundle; import android.support.v4.app.fragmentactivity; import com.google.android.gms.maps.cameraupdatefactory; import com.google.android.gms.maps.googlemap; import com.google.android.gms.maps.onmapreadycallback; import com.google.android.gms.maps.supportmapfragment; import com.google.android.gms.maps.model.latlng; import com.google.android.gms.maps.model.markeroptions; public class MapsActivity extends FragmentActivity implements OnMapReadyCallback protected void oncreate(bundle savedinstancestate) { super.oncreate(savedinstancestate); setcontentview(r.layout.activity_maps); SupportMapFragment mapfragment = (SupportMapFragment) getsupportfragmentmanager().findfragmentbyid(r.id.map); mapfragment.getmapasync(this); }

8 @Override public void onmapready(googlemap map) { // Add a marker in Sydney, Australia, and move the camera. LatLng sydney = new LatLng(-34, 151); map.addmarker(new MarkerOptions().position(sydney).title("Marker in Sydney")); map.movecamera(cameraupdatefactory.newlatlng(sydney)); } } Se o arquivo de atividade de mapas não contém o código acima, substitua o conteúdo do arquivo com esse código, após o nome do pacote. 6- Testando o projeto A maneira mais simples de ver o aplicativo em ação é conectar um dispositivo Android ao seu computador. Ative as opções de desenvolvedor no dispositivo Android e configure o aplicativo e o sistema para detectar o dispositivo. Como alternativa, use o emulador Android para executar o aplicativo. Use o Android Virtual Device (AVD) Manager para configurar um ou mais dispositivos virtuais para usar com o emulador Android quando você criar e executar o aplicativo. É necessária uma imagem do emulador com a plataforma Google APIs baseado no Android ou mais recente. No Android Studio, clique na opção de menu Run (ou no ícone do botão Play) para executar o aplicativo. Quando solicitado a escolher um dispositivo, selecione uma das seguintes opções: - Selecione o dispositivo Android conectado ao computador. - Como alternativa, selecione o botão de opção Launch emulator e escolha o dispositivo virtual configurado anteriormente.

9 Clique em OK. O Android Studio invoca o Gradle para compilar o aplicativo e exibe os resultados no dispositivo ou no emulador. A abertura do aplicativo pode demorar alguns minutos. Será exibido um mapa com um marcador posicionado em Sidnei, Austrália. Se o mapa não for exibido, confirme a conclusão de todas as etapas descritas nesta página. Especificamente, verifique se adicionou uma chave de API como descrito acima.