Problema

Você gostaria de exibir um ou mais locais em um mapa para o usuário.

Solução

A maneira mais simples de mostrar ao usuário um mapa é criar uma intent com a localização de dados e passá-lo para o sistema Android para a execução de um aplicativo de mapeamento. Vamos olhar com mais profundidade este método para fazer uma série de tarefas diferentes em outra dica posterior. Além disso, os mapas podem ser incorporados dentro do seu aplicativo usando o MapView e MapActivity fornecidas pelo Google Maps SDK.

A API do Google Maps é um módulo add-on para o core do SDK, embora ainda sejam agrupados. Se você não tiver o Google APIs SDK, abra o SDK manager e você vai encontrar um pacote para cada nível de API listadas “Third-party Add-ons”.

No fim de utilizar o API do Google Maps na sua aplicação, uma chave de API deve primeiro ser obtida do Google. Esta chave é construída usando uma chave privada que é assinada com sua aplicação .
Sem uma chave de API, as classes de mapeamento podem ser utilizados, mas nenhuma parte do mapa será retornado para o aplicativo.

Se você estiver executando o código em um emulador para testar, para operar corretamente deve-se criar uma AVD com o SDK que inclui as APIs do Google para o mapeamento.

Com a chave API na mão e uma plataforma de testes adequado no lugar, você está pronto para começar.

Como Funciona

Para mostrar um mapa, basta criar uma instância de MapView dentro de um MapActivity. Um dos atributos necessários que devem ser passados ​​para o MapView em seu layout XML é a chave API que você obteve do Google. Ver o código.

1
2
3
4
5
6
7
8

<com.google.android.maps.MapView
    	android:id="@+id/map"
    	android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:enabled="true"
        android:clickable="true"
        android:apiKey="API_KEY_STRING_HERE"
/>

Nota: Ao adicionar MapView a um layout XML, o nome do pacote totalmente qualificado deve ser incluído porque a classe não existe no android.id.view ou android.widget.

Embora, MapView pode ser instanciado a partir do código, bem como, a chave API ainda é necessária como um parâmetro de construtor.
MapView mapa = new MapView (this,”API_KEY_STRING_HERE”);
Além disso, o manifesto do aplicativo deve declarar o seu uso da biblioteca Maps, que duplamente age como um filtro para Android Market para remover o aplicativo a partir de dispositivos que não têm esta capacidade.

Agora, vamos olhar um exemplo que coloca a última localização conhecida do usuário em um mapa e exibe.

Observe as permissões declaradas para INTERNET e ACCESS_FINE_LOCATION. Este último só é necessário porque este exemplo é ligar de volta para o LocationManager para obter o valor em cache local. O outro ingrediente-chave que devem estar presentes no manifesto é a tag <uses-library> referenciando do Google Maps API. Android requer este item corretamente vinculado a biblioteca externa para o seu aplicativo exexutar, mas também serve para outro propósito. A Declaração library é usada pelo Android Market para filtrar o aplicativo para que ele não pode ser instalado em dispositivos que não estão equipados com a biblioteca de mapeamento adequada. ver código:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
<TextView
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:gravity="center_horizontal"
    android:text="Mapa com a sua localização"
    />
    <com.google.android.maps.MapView
    	android:id="@+id/map"
    	android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:enabled="true"
        android:clickable="true"
        android:apiKey="API_KEY_HERE"
    />
</LinearLayout>

Observe a localização da chave API que você deve digitar. Além disso, observe que o MapView não tem de ser a única coisa no layout de atividade, a despeito do fato que deve ser inflado dentro de um MapActivity. Ver

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

public class DicaMapasActivity extends MapActivity {
 
	MapView map;
	MapController controller;
 
	@Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
 
        map = (MapView)findViewById(R.id.map);
        controller = map.getController();
 
        LocationManager manager = (LocationManager)getSystemService(Context.LOCATION_SERVICE);
        Location location = manager.getLastKnownLocation(LocationManager.GPS_PROVIDER);
        int lat, lng;
        if (location != null){
        	//Converte para micrograus
        	lat = (int)(location.getLatitude() * 1000000);
        	lng = (int)(location.getLongitude() * 1000000);
        } else {
        	lat = -23426118;
        	lng = -51938210;
        }
        GeoPoint mapCenter = new GeoPoint(lat, lng);
        controller.setCenter(mapCenter);
        controller.setZoom(15);
    }
 
	@Override
	protected boolean isRouteDisplayed() {
		return false;
	}
}

Esta Atividade leva a localizações do usuário mais recentes, e no pronto central do mapa, todo o controle do mapa é feito através de uma instância MapController, que obtemos chamando MapView.getController (), o controlador pode ser usado para fazer zoom, pan e de outra forma ajustar o mapa na tela, neste exemplo, usamos setCenter() do controlador e setZoom() para ajustar a visualização do mapa.

MapController.setCenter () toma um GeoPoint como parâmetro, que é levemente diferente do local que recebemos os serviços Android. A principal diferença é que GeoPoint expressa latitude e longitude em termos de micrograus (ou graus * 1E6) em vez de um valor decimal que representa graus inteiros. Portanto, nós, devemos converter os valores locais antes de aplicá-los ao mapa.

MapController.setZoom () permite que o mapa seja programaticamente ampliada para um nível específicado, entre 1 e 21. Por padrão, o mapa de zoom será nível 1, que a documentação do SDK define como sendo uma visão global, com cada nível crescente aumentado no mapa por dois. Veja:

Mapa de localização do usuário

A primeira coisa que provavelmente você vai notar é que o mapa não mostra nenhuma indicação no ponto de localização (como um alfinete). Nas próximas dicas criaremos essas anotações, e mostraremos como personalizá-los. Até a próxima.