Obtendo o Google Maps API v2

Obtendo o Google Maps API v2

Android API é distribuído como parte do Google Play services SDK, que você pode fazer o download com o Android SDK Manager. Para usar o Android Google Maps API v2 em seu app, você primeiro precisa instalar o Google Play services SDK. Para aprender a instalar o pacote, consulte a documentação de serviços Google Play. Como pré-requisito, você precisa instalar o Android SDK. Para saber como fazer isso, consulte a seção Como instalar o SDK.

The Google Maps API Key

Para acessar o Google Maps Mapas servidores com a API, você terá que adicionar uma chave de API de mapas do seu aplicativo. A chave é livre, você pode usá-lo com qualquer um de seus aplicativos que chamam os mapas API, e suporta um número ilimitado de usuários. Você obter uma chave de API de Mapas do Google APIs Console, fornecendo certificado de assinatura do seu aplicativo e o seu nome de pacote.

Para acessar o Google Maps Mapas servidores com a API, você terá que adicionar uma chave de API de mapas do seu aplicativo. A chave é livre, você pode usá-lo com qualquer um de seus aplicativos que chamam os mapas API, e suporta um número ilimitado de usuários. Você obter uma chave de API de Mapas do Google APIs Console, fornecendo certificado de assinatura do seu aplicativo e o seu nome de pacote. Uma vez que você tenha a chave, você adicioná-lo à sua aplicação, adicionando um elemento de seu aplicativo, arquivo de manifesto AndroidManifest.xml.

Compreensão do processo de registo do seu pedido e a obtenção de uma chave requer algum conhecimento de Android o processo de publicação e requisitos. Em resumo, todos os aplicativos Android deve ser assinado com certificado digital para que você mantenha a chave privada. Porque os certificados digitais são únicas, elas oferecem uma forma simples de identificar de maneira exclusiva o seu app.

Mapas chaves de API são ligadas ao certificado específico/pacote pares, em vez de usuários ou aplicativos. Você só precisa de uma chave para cada certificado, não importa quantos usuários você tem para um aplicativo. Os aplicativos que usam o mesmo certificado pode usar a mesma chave de API. No entanto, a prática recomendada é entrar cada um dos seus aplicativos com um certificado diferente e obter uma chave diferente para cada um

Obter uma chave para a sua aplicação requer várias etapas. Estas etapas estão descritas aqui, e descrito em detalhes nas seções a seguir. 1. Recuperar as informações sobre o seu pedido do certificado. 2. Registrar um projeto no Google APIs Console e adicionar os mapas API como um serviço para o projeto. 3.Uma vez que você tenha um projeto, você pode solicitar um ou mais teclas. 4. Por fim, você pode adicionar a chave para o seu aplicativo e iniciar o desenvolvimento.

Exibindo informações de certificado

os mapas chave de API é baseada em uma forma curta de sua aplicação certificado digital, conhecida como a sua impressão digital SHA-1. A impressão digital é um único string de texto gerado a partir do comumente utilizado algoritmo hashing SHA-1. Porque a própria impressão digital é única, o Google Maps utiliza-o como uma maneira de identificar o seu pedido. Para exibir o SHA-1 impressão digital para o seu certificado, em primeiro lugar certifique-se de que você tem o próprio certificado. Você pode ter dois certificados:

Debug certificado: o Android SDK tools gerar esse certificado automaticamente quando você for fazer um "debug" construir a partir da linha de comando, ou quando você criar e executar um projeto no Eclipse sem exportá-la para um aplicativo em repouso. O certificado só é válido para utilização com um aplicativo que você teste; você não consegue publicar um app que é assinado com um certificado debug. A debug certificado é descrito em mais detalhes na seção Assinatura em modo de depuração no Android Market Documentação para o desenvolvedor.

Emissão do certificado: o Android SDK tools gerar esse certificado quando você for fazer um "release" construir com um programa ant ou o Eclipse. Você também pode gerar o certificado usando o keytool. Este certificado pode ser usado com um app que você solte-o para o mundo. Uma vez que você tenha o certificado correto para as suas necessidades, você pode exibir seu SHA-1 impressão digital usando o keytool.

• Para mais informações sobre keytool, consulte a documentação no http://docs.oracle.com/javase/6/docs/technotes/tools/windows/keytool.html. ▸ Exibindo o debug exibindo o certificado digital certificado digital comunicado

Criando um projeto do API

Depois de ter seu certificado digital assinatura, criar ou modificar um projeto para a sua aplicação no APIs Console Google e se registrar para a API do Google Maps.

Para obter um projeto e se inscrever para o API:1.In um navegador, navegue até a APIs Console Google. ◦ Se você não usou o Google APIs Console antes, você será solicitado a criar um projeto que você usa para controlar o uso da API do Google Maps para Android. Clique em Criar Projeto, o Console cria um novo projeto chamado Projeto API. Na próxima página, este nome aparece no canto superior esquerdo. Para renomear ou gerenciar o projeto, clique em seu nome.◦ Se você já estiver usando o APIs Console Google, você verá imediatamente uma lista dos seus projetos existentes e os serviços disponíveis. Ele ainda é uma boa idéia usar um novo projeto para o Google Maps API Android, é só selecionar o nome do projeto no canto superior esquerdo e, em seguida, clique em Criar.

2.Você deve ver uma lista de APIs e serviços na janela principal. Se você não fizer isso, selecione Serviços na barra de navegação à esquerda.3.In a lista de serviços exibidos no centro da página, role para baixo até ver Android

Google Maps API v2. À direita da entrada, clique no indicador de interruptor de modo que ele está ligado.4.A exibe os da API do Google Maps para Android Termos de Serviço. Se você concorda com os termos de serviço, clique na caixa abaixo os termos de serviço e clique em Aceitar. Assim, você retorna para a lista de APIs e serviços.

Agora você está pronto para obter uma chave de API do Google Maps.

Obtenção de uma chave de API

Se seu aplicativo está registrado com o serviço Google Maps para Android API v2, então você pode pedir uma chave API. É possível registrar mais de uma tecla por projeto.

Para obter a chave:1.In a barra de navegação à esquerda, clique em Acesso API.2.In a página resultante, clique em Criar Nova Chave Android ....3.Na caixa de diálogo resultante, digite o SHA-1 da impressão digital, em seguida, um ponto e vírgula, em seguida, o nome do pacote do aplicativo. Por exemplo:

BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75;com.example.android.mapexample

4.O Google APIs Console responde exibindo chave para aplicativos Android (com certificados), seguido por uma chave de API quarenta caracteres, por exemplo:

AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

5.Copy este valor de chave. Você vai usá-lo na próxima etapa.

Adicionando a chave de API para a sua aplicação

O passo final é adicionar a chave de API para a sua aplicação. Vai no manifesto do aplicativo, contido no arquivo AndroidManifest.xml. De lá, a API do Google Maps lê o valor da chave e passa para o servidor do Google Maps, que, em seguida, confirma que você tenha acesso a dados do Google Maps.

Para adicionar a chave para a sua aplicação:1.Em AndroidManifest.xml, adicione o seguinte elemento como um filho do elemento <application>, inserindo-o pouco antes da tag de fechamento </ application>:

<meta-data android:name="com.google.android.maps.v2.API_KEY" android:value="your_api_key"/>

substituindo a sua chave API para your_api_key. Este elemento define o com.google.android.maps.v2.API_KEY chave para o valor your_api_key e faz com que a chave de API visível para qualquer MapFragment em sua aplicação.

2.Adicione os seguintes elementos ao seu manifesto. Substitua com.example.mapdemo com o nome do pacote da sua aplicação.

<permission android:name="com.example.mapdemo.permission.MAPS_RECEIVE" android:protectionLevel="signature"/><uses-permission android:name="com.example.mapdemo.permission.MAPS_RECEIVE"/>

3.Guarde AndroidManifest.xml e re-construir a sua aplicação.

Especifique as configurações no manifesto do aplicativo

Um aplicativo Android que usa o Google Maps API Android precisa especificar as seguintes configurações no seu arquivo de manifesto, AndroidManifest.xml:• As permissões que dão o acesso do aplicativo a recursos do sistema Android e para os servidores do Google Maps.• Notificação de que o aplicativo requer OpenGL ES versão 2. Serviços externos podem detectar essa notificação e agir em conformidade. Por exemplo, o Google Play Store não irá exibir o aplicativo em dispositivos que não possuem OpenGL ES versão 2.• A chave de API do Google Maps para a aplicação. A chave confirma que você se registrou com o serviço Google Maps por meio de APIs Console Google.

Esta seção descreve cada uma dessas configurações e como adicioná-los ao AndroidManifest.xml.

especificando permissões

Definir permissões, adicionando elementos <uses-permission> como filhos do elemento <manifest>. A sintaxe é:

<uses-permission android:name="permission_name"/>

Por exemplo, para solicitar a permissão Internet, acrescentar:

<uses-permission android:name="android.permission.INTERNET"/>

Além de permissões exigidas por outras partes do seu aplicativo, você deve adicionar as seguintes permissões para usar o Google Maps API Android:• android.permission.INTERNET Usado pela API para baixar peças de mapas a partir de servidores do Google Maps.• android.permission.ACCESS_NETWORK_STATE Permite que o API para verificar o status da conexão, a fim de determinar se os dados podem ser transferidos.• com.google.android.providers.gsf.permission.READ_GSERVICES Permite que o API para acessar serviços baseados na web do Google.• android.permission.WRITE_EXTERNAL_STORAGE Permite que o API para armazenar em cache dados azulejo mapa na área de armazenamento externo do

dispositivo.

As seguintes permissões são recomendados, mas pode ser ignorado se o seu aplicativo não acessa a localização atual do usuário, por meio de programação, ou ativando a camada de My Location.• android.permission.ACCESS_COARSE_LOCATION Permite a API para usar dados de celulares Wi-Fi ou celular (ou ambos) para determinar a localização do dispositivo.•android.permission.ACCESS_FINE_LOCATION Permite a API para usar o Sistema de Posicionamento Global (GPS) para determinar a localização do dispositivo para dentro de uma área muito pequena.

<uses-permission android:name="android.permission.INTERNET"/><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/><uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES"/><uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/><uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

Exigir OpenGL ES versão 2

Porque a versão 2 da API do Google Maps para Android requer a versão OpenGL ES 2, você deve adicionar um elemento <uses-feature> como um filho do elemento <manifest> no AndroidManifest.xml:

<uses-feature android:glEsVersion="0x00020000" android:required="true"/>

Isso notifica serviços externos da exigência. Em particular, tem o efeito de impedir que o Google Play Store de exibir seu aplicativo em dispositivos que não suportam OpenGL ES versão 2.

Adicionar um mapa

Depois de adicionar as referências aos serviços de jogo SDK Google, adicionou a sua chave e personalizou seu manifesto Android, você pode tentar adicionar um mapa para a sua aplicação.

A maneira mais fácil de testar se o aplicativo está configurado corretamente é adicionar um mapa simples. Você vai ter que fazer alterações em dois arquivos: main.xml e MainActivity.java. Por favor, note que o código abaixo é apenas útil para testar as configurações em um aplicativo Android visando API 12 ou mais tarde, este código não deve ser usado em um aplicativo de produção. Exemplos de como adicionar um código mais robusto aparecem ao longo deste guia e no código de exemplo.1.No main.xml, adicione o seguinte fragmento.

<?xml version="1.0" encoding="utf-8"?><fragment xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/map" android:layout_width="match_parent" android:layout_height="match_parent" android:name="com.google.android.gms.maps.MapFragment"/>

2.In MainActivity.java, adicione o seguinte código.package com.example.mapdemo;

import android.app.Activity;import android.os.Bundle;

public class MainActivity extends Activity {

@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); }}

3. Construir e executar o aplicativo. Você deverá ver um mapa. Se você não vê um mapa, confirme que você tiver concluído todas as etapas que aparecem no início deste documento.

Documents

Obtendo o Google Maps API v2