Mapbox的是最新中文API（一），www_ww_ww原创Mapbox Android SDK

Mapbox Android SDK

Mapbox Android SDK本指南将指导您完成Mapbox在Android Studio上加载地图 并改变地图的风格。

当然!我们还积极发展Mapbox Android SDK和将更新本指南和添加新的改进的神奇功能。

开始

开始之前你需要准备:

• An access token你可以在此帐户页面申请.

• Android Studio 你可以从谷歌免费下载

• 谷歌玩开发者账户(可选) 如果你想发布您的应用程序到谷歌play,你需要一个谷歌开发者账户。即使没有,你还是可以预览应用程序在一个Android虚拟设备(AVD)或演示应用程序从一个SDK安装在一个物理设备。

配置android studio

新建一个工程:

• 项目名称 My First Mapbox App
• 公司域设置为 mycompany.com

最低SDK, select API 15: Android 4.0.3 (IceCreamSandwich)。这是目前Mapbox Android SDK的支持的最低的API级别。

单击Next进入Activity选择屏幕。选择空Activity并单击Next。接受默认的 Activity Name和 Layout Name并单击Finish。

建立一个Android虚拟设备

Android Studio可以帮助你在你的电脑上设置虚拟Android设备来帮助应用程序开发时的测试。设置一个,点击安卓虚拟设备(AVD)管理器图标,然后点击创建虚拟设备按钮。从手机的类别,选择Nexus 5 x,然后单击Next。选择您想测试的版本(本指南x86,Android 6.0)。了解更多点击文档.

安装Mapbox

我们建议在Gradle中进行。将自动安装必要的依赖关系和SDK二进制文件从Maven中央存储库中的Mapbox Android SDK

安装当前稳定版本,添加您的模块构建文件 ~/MyFirstMapboxApp/app/build.gradle:

     
     
     

      
      
      repositories{
        mavenCentral()}
     
     
     
     
     
     

      
      
      dependencies{
        compilefileTree(dir:'libs',include:['*.jar'])testCompile'junit:junit:4.12'compile'com.android.support:appcompat-v7:24.1.1'
     
     
     
     
     
     

      
      
      compile('com.mapbox.mapboxsdk:mapbox-android-sdk:4.2.0-beta.1@aar')
     
     
     
     
     
     

      
      
      {
        transitive=true}
     
     
     
     
     
     

      
      
      }
     
     
     

应用程序权限

确保以下核心权限在您的项目 AndroidManifest.xml文件从 ~/MyFirstMapboxApp/app/src/main/:

     
     
     

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

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

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

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

如果应用程序是针对Android棉花糖(API 23)或更高版本的在运行时需要请求权限。另外,你需要在清单文件中添加 <application>标签:

<serviceandroid:name="com.mapbox.mapboxsdk.telemetry.TelemetryService"/>

访问令牌（Access tokens）

使用Mapbox服务和api,如地图、方向,和地理编码,你必须有一个Mapbox访问令牌。你可以找到你的访问令牌你的帐户设置,您可以检索当前令牌并生成新的。访问令牌帮助您跟踪使用情况和最小化中断事件令牌需要撤销。

首先,进入你的帐户设置,创建一个新的访问令牌 My First Mapbox App。一旦你有你的令牌,开放 strings.xml文件从 ~/MyFirstMapboxApp/app/src/main/res/values.

为你的访问令牌（accesstoken）:添加一个新的字符串

<resources>

<stringname="app_name">My First Mapbox App</string>

<stringname=