Google Maps Android API v2 (1)- 入门

才可以开始工作的API,你将需要下载的API,并确保你有一个谷歌地图Android的API V2关键。API和关键是免费提供的。

  1. 概观
  2. 获得谷歌地图Android的API V2
  3. 谷歌地图API密钥
    1. 显示的证书信息
    2. 创建一个API项目
    3. 获取API密钥
    4. 添加到您的应用程序的API密钥
  4. 指定的应用程序清单的设置
    1. 指定权限
    2. 需要OpenGL ES的第2版
  5. 添加地图

概观

创建一个新的Andr​​oid应用程序,使用谷歌地图的Andr​​oid API V2需要几个步骤。许多在本节中列出的步骤,只会进行一次,但一些信息,为未来的应用将是一个方便的参考。地图加入到Android应用程序的整个过程如下:

  1. 下载并配置谷歌播放服务 SDK。谷歌地图的Android API分发该SDK的一部分。
  2. 获取API密钥。要做到这一点,你需要注册一个项目,谷歌的API控制台,并得到您的应用程序的签名证书。
  3. 指定应用程序清单中的设置
  4. 添加映射到一个新的或现有的Andr​​oid项目。
  5. 发布您的申请!

你不妨开始看一些 示例代码,这是谷歌播放服务SDK包含。

获得谷歌地图Android的API V2

API分发的一部分,谷歌播放服务SDK,您可以下载的Android SDK管理器。要使用谷歌地图的Android API V2在您的应用程序,你将首先需要安装谷歌播放服务SDK。要了解如何安装包,看到 谷歌Play业务文档。

作为先决条件,你需要安装Android SDK。要学习如何做到这一点,请参阅 安装SDK

谷歌地图API密钥

注: Android的谷歌地图API V2使用密钥管理的新*。从谷歌地图Android的卷应用,俗称MapView类,现有密钥将无法正常工作与V2的API。

要访问谷歌地图API的地图服务器,你必须到您的应用程序添加一个地图API密钥。关键是免费的,你可以使用它与任何您的应用程序调用的地图API,它支持无限数量的用户。从谷歌的API控制台获得地图API密钥提供您的应用程序的签名证书,其包名。一旦你有钥匙,你把它添加到你的应用程序,您的应用程序清单文件AndroidManifest.xml中添加元素。

Android的出版流程和要求了解的过程中,您的应用程序注册并获得关键需要一些知识。总之,所有的Andr​​oid应用程序必须使用数字证书,你持有的私钥签名。由于数字证书是唯一的,他们唯一标识您的应用程序提供了一种简单的方法。这使它们可以跟踪您的应用系统,如谷歌播放商店,并为您的应用程序使用的资源,如谷歌地图服务器跟踪。

注:请参阅更多有关数字证书签名的应用到Android指南 。

地图API密钥的链接,而不是特定的证书/包对用户或应用程序。你只需要一个键,不管你有多少用户的应用程序的每个证书。使用相同的证书的应用程序可以使用相同的API密钥。然而,推荐的做法是签署了彼此不同的证书,并获得您的应用程序为每一个不同的密钥。

获取一键为您的应用程序需要几个步骤。这里描述这些步骤,在下面的章节中详细描述。

  1. 检索您的应用程序的证书信息。
  2. 注册一个项目,谷歌的API控制台,并添加地图API作为一个服务项目。
  3. 一旦你有一个项目落户,你可以请求一个或多个键。
  4. 最后,你可以添加你的钥匙到您的应用程序,并开始发展。

显示的证书信息

地图API密钥是基于您的应用程序的数字证书,被称为SHA-1指纹的简短形式。指纹常用的SHA-1散列算法生成的是一个独特的文本字符串。因为本身独特的指纹,谷歌地图使用它作为一种方法来确定您的应用程序。

要显示您的证书的SHA-1指纹,首先确保您有证书本身。您可能有两个证书:

  • 调试证书:Android的SDK工具,当你做“调试”建立在命令行,或当它作为一个发布的应用程序而不导出生成并运行一个项目从Eclipse自动生成此证书。该证书只能使用一个应用程序,你测试,你不能发布一个应用程序的调试证书签署。调试 在Android开发人员文档在调试模式下的部分签名证书中详细描述。您可以生成一个API密钥从这个证书,但只能使用密钥进行测试,从来没有进行生产。
  • 释放证明:Android的SDK工具生成此证书,当你做一个“释放”的身材,无论是蚂蚁程序或者Eclipse。您还可以生成此证书使用密钥工具程序。向世界释放一个应用程序,你可以使用此证书。一旦你拥有了正确的证书为您的需求,您可以显示其SHA-1指纹使用keytool的程序。
  • 的Keytool的更多信息,请参阅文档在 http://docs.oracle.com/javase/6/docs/technotes/tools/windows/keytool.html

显示调试凭证指纹

显示释放证书指纹

创建一个API项目

一旦你有你的签名证书指纹,创建或修改一个项目为您的应用程序在谷歌的API控制台注册​​地图API。

为了得到一个项目,并注册API:

  1. 在浏览器中,导航到谷歌的API控制台
    • 如果你还没有使用谷歌的API控制台前,系统会提示您创建一个项目,你用它来 ​​跟踪您使用的谷歌地图Android的API。点击创建项目 ;控制台创建一个新项目,叫做API项目。在接下来的页面中,这个名字出现在左上角。要重命名或以其他方式管理该项目,单击其名称。
    • 如果你已经在使用谷歌API控制台,您将立即看到您现有的项目和可用的服务的列表。它仍然是一个好主意,用谷歌地图Android API的一个新的项目,所以选择左上角中的项目名称,然后单击“ 创建“
  2. 在主窗口中,你应该看到一个列表的API和服务。如果你不这样做,从左侧的导航栏中选择服务
  3. 在中心的网页显示在服务列表中,向下滚动,直到你看到谷歌地图Android的API V2。条目的右侧,按一下开关指示灯,它是。
  4. 这显示Android的谷歌地图API服务条款。如果您同意服务条款,单击下面的复选框的服务条款,然后单击“ 接受“。返回到列表的API和服务。

你现在准备好地图API密钥。

获取API密钥

如果您的应用程序与谷歌地图的Andr​​oid的API v2的服务注册,那么你可以申请API密钥。这是可能的,每个项目注册多个键。

为了拿到钥匙:

  1. 导航到您的项目在谷歌的API控制台
  2. 在左侧导航栏中,单击“ API访问
  3. 在结果页面中,单击“ 创建新的Andr oid重点
  4. 在出现的对话框中,输入的SHA-1指纹,然后一个分号,然后您的应用程序的包名。例如:

    BB :0D :AC :74 :D3 :21 :E1 :43 :67 :71 :9B :62 :91 :AF :A1 :66 :6E :44 :5D :75 ; COM 。例如机器人。mapexample
  5. 谷歌的API控制台响应显示键Android应用程序(带证书),其次是一个40个字符的API密钥,例如:

    AIzaSyBdVl - cTICSwYKrZ95SuvNw7dbMuDt1KG0
  6. 复制此键值。在下一个步骤中,你会使用它。

添加到您的应用程序的API密钥

最后一步是添加到您的应用程序的API密钥。它在您的应用程序的清单,包含在文件AndroidManifest.xml中去。从那里,地图API读取键值,并把它传递给谷歌地图服务器,然后确认您可以访问谷歌地图数据。

要添加到您的应用程序的关键:

  1. AndroidManifest.xml中,添加下列元素作为一个孩子的的<application> 元素,将它插入前结束标记</应用程序>

    <元数据
        的Android版 ​​本:名称= “com.google.android.maps.v2.API_KEY”的
        Android版 ​​本:值=的“API_KEY” />

    以您的API密钥为API_KEY。此元素设置的关键com.google.android.maps.v2.API_KEYAPI_KEY和使得可见任何MapFragment在你的应用程序API密钥 。

  2. 以下元素添加到您的清单。更换com.example.mapdemo 您的应用程序的包名。

    <permission
            android:name="com.example.mapdemo.permission.MAPS_RECEIVE"
            android:protectionLevel="signature"/>
    <uses-permissionandroid:name="com.example.mapdemo.permission.MAPS_RECEIVE"/>
  3. 保存AndroidManifest.xml文件,并重新建立你的应用程序。

指定的应用程序清单的设置

使用谷歌地图的Android API的Android应用程序需要在其清单文件AndroidManifest.xml中指定以下设置:

  • 给Android系统的功能和谷歌地图服务器应用程序访问权限。
  • 通知应用程序需要OpenGL ES版本2。外部服务可以检测此通知,并采取相应的行动。例如,谷歌播放商店不会显示设备上的应用程序不具备OpenGL ES的第2版。
  • 地图API密钥的应用程序。确认您已经注册,通过谷歌地图服务的谷歌API控制台的关键。

本节介绍这些设置和如何将它们添加到 AndroidManifest.xml文件

指定权限

设置权限增加 <uses-permission>的 要素作为儿童的<manifest>元素。语法是:

<使用许可的android:名称=的“PERMISSION_NAME” />

例如,要求Internet权限,添加:

<使用权限的Android:名称= “android.permission.INTERNET” />

除了您的应用程序的其他部分所需的权限,则必须添加以下权限,以便使用谷歌地图的Andr​​oid API:

以下权限的建议,但如果您的应用程序不会访问用户的当前位置,无论是编程,或者通过启用“我的位置”层可以忽略不计。

需要OpenGL ES的第2版

由于第2版的谷歌地图的Android API需要OpenGL ES版本2,您必须添加一个<uses-feature> 元素作为一个孩子的<manifest>元素在 AndroidManifest.xml中

<使用功能
        的Android版 ​​本:glEsVersion = “0x00020000”
        的android:需要= “” />

这将通知外部服务的要求。特别是,它具有防止谷歌播放存储设备上显示您的应用程序不支持OpenGL ES版本2的效果。

添加地图

当你添加引用谷歌播放服务SDK,你的钥匙和定制你的Andr​​oid清单,你可以尝试添加到您的应用程序的地图。

测试您的应用程序的配置是否正确,最简单的方法是添加一个简单的地图。你将不得不进行修改两个文件:main.xml中和 MainActivity.java。请注意,下面的代码是唯一有用的测试针对Android的API 12或更高版本的应用程序设置,此代码不应该被用在生产应用程序。如何添加更健壮的代码的例子出现在本指南中的示例代码

  1. main.xml中,添加下面的代码片段。

    <?XML
    
              
             
             
             
  2. MainActivity.java,添加下面的代码。

    package com.example.mapdemo;
    
    import android.app.Activity;
    import android.os.Bundle; publicclassMainActivityextendsActivity{     @Override
        protectedvoid onCreate(Bundle savedInstanceState){
            super.onCreate(savedInstanceState);
            setContentView(R.layout.main);
        }
    }
  3. 生成并运行您的应用程序。你应该看到一个地图。如果你不看地图,确认你已经完成了所有本文档中出现较早的步骤。

上一篇:google map android api v2


下一篇:JVM菜鸟进阶高手之路十二(jdk9、JVM方面变化, 蹭热度)