Amap API

https://lbs.amap.com/api
Admin
Amap API provides a comprehensive suite of location-based services for developers, including...
Tokens:2,171,930
Snippets:10,591
Trust Score:10
Update:2 days ago
Show doc for...
Tokens:
Raw
### route command usage and example

Source: https://lbs.amap.com/api/cli/map-cli/reference

Shows the 'amap-gui route' command options and a usage example with its JSON response. The command requires --from, --to, and --type; --city is required for transit mode. The example uses driving mode from 中关村 to 北京大学东门.

```bash
#                          
# amap-gui route [options]  类型                                                    是否必传        描述
# --json '<JSON>'          string                                                  No              完整 JSON 输入（优先级最高）
# --from <地名|lng,lat>    地名|lng,lat                                            Yes             起点（地名或坐标）
# --from-name <name>       string                                                  No              起点显示名称（配合坐标使用）
# --to <地名|lng,lat>      地名|lng,lat                                            Yes             终点（地名或坐标）
# --to-name <name>         string                                                  No              终点显示名称（配合坐标使用）
# --type <mode>            driving|walking|riding|transit                           Yes             出行方式
# --waypoints <p1+p2+..>   string                                                  No              加号分隔的途经点（仅 driving，最多 16 个）
# --policy <policy>        fastest|least_fee|shortest|no_highway|avoid_jam          No              驾车策略
# --strategy <strategy>    fastest|least_cost|least_walk|most_comfort|no_subway     No              公交策略
# --city <city>            string                                                  transit 必填    城市名（公交模式必须指定）

# example
amap-gui route --from 中关村  --to 北京大学东门 --type driving
```

```json
# 返回结果
# {
#   "success": true,
#   "data": {
#     "state": {
#       "from": {
#         "name": "中关村",
#         "position": [
#           116.321669,
#           39.985266
#         ]
#       },
#       "to": {
#         "name": "北京大学东门",
#         "position": [
#           116.315811,
#           39.992127
#         ]
#       },
#       "waypoints": [],
#       "type": "driving"
#     },
#     "summary": {
#       "distance": 2090,
#       "time": 391,
#       "steps": [
#         {
#           "instruction": "沿北四环西路辅路向东行驶474米左转调头",
#           "road": "北四环西路辅路",
#           "distance": 474,
#           "time": 119,
#           "action": "左转调头"
#         },
#         {
#           "instruction": "沿北四环西路辅路向西行驶915米右转",
#           "road": "北四环西路辅路",
#           "distance": 915,
#           "time": 136,
#           "action": "右转"
#         },
#         {
#           "instruction": "沿中关村北大街向北行驶701米到达目的地",
#           "road": "中关村北大街",
#           "distance": 701,
#           "time": 136,
#           "action": ""
#         }
#       ],
#       "tolls": 0
#     }
#   },
#   "error": null
# }
```

--------------------------------

### 引入AMapFoundationKit.h和AMapTrackKit.h头文件

Source: https://lbs.amap.com/api/ios-track/guide/guijishangbao/start-guijishangbao

在调用猎鹰功能的类中引入AMapFoundationKit.h和AMapTrackKit.h两个头文件。

```Objective-C
#import <AMapFoundationKit/AMapFoundationKit.h>
#import <AMapTrackKit/AMapTrackKit.h>
```

--------------------------------

### AMap.DomUtil.getViewport example

Source: https://lbs.amap.com/api/javascript-api/guide/utils/util

Demonstrates using AMap.DomUtil.getViewport to get the width and height of the document body. The returned object has width and height properties.

```JavaScript
var body = AMap.DomUtil.getViewport(document.body);
var width = body.width;
var height = body.height;
```

--------------------------------

### Setup Navigation with AMapNaviDriveManager

Source: https://lbs.amap.com/api/ios-navi-sdk/summary

Configures the shared AMapNaviDriveManager instance: disables automatic location updates, adds data representatives (driveView, trafficBarView, self), and calculates a drive route with start and end points.

```objectivec
[[AMapNaviDriveManager sharedInstance] setPausesLocationUpdatesAutomatically:NO];

//将self 、driveView、trafficBarView 添加为导航数据的Representative，使其可以接收到导航诱导数据
[[AMapNaviDriveManager sharedInstance] addDataRepresentative:self.driveView];
[[AMapNaviDriveManager sharedInstance] addDataRepresentative:self.trafficBarView];
[[AMapNaviDriveManager sharedInstance] addDataRepresentative:self];

//算路
[[AMapNaviDriveManager sharedInstance] calculateDriveRouteWithStartPoints:@[self.startPoint]
                                                                endPoints:@[self.endPoint]
                                                                wayPoints:nil
                                                          drivingStrategy:AMapNaviDrivingStrategySingleDefault];
```

--------------------------------

### 执行pod install命令

Source: https://lbs.amap.com/api/ios-location-sdk/guide/create-project/idfa-guide

保存Podfile后，在命令行执行pod install来安装依赖。如果无法更新SDK，需要先运行pod repo update更新pod库。

```bash
$pod install
```

--------------------------------

### Start continuous location updates (Swift)

Source: https://lbs.amap.com/api/ios-location-sdk/guide/get-location/backgroundlocation

Swift equivalent of the Objective-C example. Sets pausesLocationUpdatesAutomatically to false for iOS versions before 9, and enables allowsBackgroundLocationUpdates for iOS 9 and later. Then calls startUpdatingLocation to begin continuous updates.

```Swift
//iOS 9（不包含iOS 9） 之前设置允许后台定位参数，保持不会被系统挂起
locationManager.pausesLocationUpdatesAutomatically = false

//iOS 9（包含iOS 9）之后新特性：将允许出现这种场景，同一app中多个locationmanager：一些只能在前台定位，另一些可在后台定位，并可随时禁止其后台定位。
if UIDevice.current.systemVersion._bridgeToObjectiveC().doubleValue >= 9.0 {
    locationManager.pausesLocationUpdatesAutomatically = true
}

//开始持续定位
locationManager.startUpdatingLocation()
```

--------------------------------

### startEmulatorNavi:

Source: https://lbs.amap.com/api/ios-navi-sdk/guide/route-plan/independentcalculateroute

开始模拟导航，使用独立路径规划的路线结果进行模拟导航。

```APIDOC
## [Objective-C] startEmulatorNavi:

### Description
开始模拟导航，使用独立路径规划的路线结果进行模拟导航。

### Method
Objective-C 方法调用

### Endpoint
[[AMapNaviDriveManager sharedInstance] startEmulatorNavi:independentRouteGroup]

### Parameters
- **independentRouteGroup** (AMapNaviRouteGroup) - Required - 独立路径规划得到的路线组对象。

### Request Example
```objectivec
[[AMapNaviDriveManager sharedInstance] startEmulatorNavi:independentRouteGroup];
```

### Response
无返回值。
```

--------------------------------

### Get driving route by longitude/latitude

Source: https://lbs.amap.com/api/javascript-api-v2/guide/services/navigation

Loads the AMap.Driving plugin asynchronously and performs a route search using longitude/latitude coordinates for start and end points. The policy is set to 0 (speed priority). The callback checks status: 'complete' for success, 'no_data' for no results, and 'error' for errors.

```javascript
AMap.plugin("AMap.Driving", function () {
  var driving = new AMap.Driving({
    policy: 0, //驾车路线规划策略，0是速度优先的策略
  });
  var startLngLat = [116.379028, 39.865042]; //起始点坐标
  var endLngLat = [116.427281, 39.903719]; //终点坐标
  driving.search(startLngLat, endLngLat, function (status, result) {
    //status：complete 表示查询成功，no_data 为查询无结果，error 代表查询错误
    //查询成功时，result 即为对应的驾车导航信息
  });
});
```

--------------------------------

### 引入头文件 (Swift)

Source: https://lbs.amap.com/api/ios-sdk/guide/route-plan/etd

在 Swift 工程的桥接文件中引入 AMapFoundationKit.h 和 AMapSearchKit.h 头文件。

```Swift
//在桥接文件中引入头文件
#import <AMapFoundationKit/AMapFoundationKit.h>
#import <AMapSearchKit/AMapSearchKit.h>
```

--------------------------------

### Get driving route by keyword

Source: https://lbs.amap.com/api/javascript-api-v2/guide/services/navigation

Loads the AMap.Driving plugin asynchronously and performs a route search using keyword addresses for start and end points. The policy is set to 0 (speed priority). The callback checks status: 'complete' for success, 'no_data' for no results, and 'error' for errors.

```javascript
AMap.plugin("AMap.Driving", function () {
  var driving = new AMap.Driving({
    policy: 0, //驾车路线规划策略，0是速度优先的策略
  });
  var points = [
    { keyword: "北京市地震局（公交站）", city: "北京" },
    { keyword: "亦庄文化园（地铁站）", city: "北京" },
  ];
  driving.search(points, function (status, result) {
    //status：complete 表示查询成功，no_data 为查询无结果，error 代表查询错误
    //查询成功时，result 即为对应的驾车导航信息
  });
});
```

--------------------------------

### startNaviWithPath

Source: https://lbs.amap.com/api/android-navi-sdk/guide/route-plan/independentcalculateroute

使用指定路线开始导航，传入导航类型和路线组。

```APIDOC
## startNaviWithPath

### Description
使用指定路线开始导航，传入导航类型和路线组。

### Method
public boolean startNaviWithPath(int naviType, AMapNaviPathGroup pathGroup)

### Parameters
- **naviType** (int) - 导航类型，参考NaviType
- **pathGroup** (AMapNaviPathGroup) - 路线组

### Returns
- **boolean** - true-成功 false-失败

### Since
7.7.0

### Notes
独立路线用于导航以后，AMapNavi中getNaviPath返回的路线会切换为独立的路线，之前的路线自动被清除，独立路线在导航销毁后会作废，不支持外部保存，不支持使用销毁前保存的独立路线进行导航。
```

--------------------------------

### - (void)setStartNaviDirectly:(BOOL)directly

Source: https://lbs.amap.com/api/ios-navi-sdk/guide/navi-component/advanced-functions

设置导航组件启动时是否直接进入导航界面，跳过路径规划页面进行算路并自动开始导航。如果设置为YES，必须设置有效的终点，否则会报错。

```APIDOC
## setStartNaviDirectly:

### Description
设置导航组件启动时，直接进入导航界面（跳过路径规划页面）进行算路并自动开始导航。

### Method
- (void)setStartNaviDirectly:(BOOL)directly

### Parameters
- **directly** (BOOL) - 是否直接进入导航界面，默认值为NO。注意：如果为YES，为了保证算路成功，还需设置有效的终点，否则会报错。

### Availability
since 5.3.0
```

--------------------------------

### GET /v5/direction/bicycling

Source: https://lbs.amap.com/api/webservice/guide/api/newroute

骑行路线规划 API，用于规划骑行路线。通过 GET 请求调用，需要提供起点和终点经纬度。

```APIDOC
## GET /v5/direction/bicycling

### Description
骑行路线规划 API，用于规划骑行路线。通过 GET 请求调用，需要提供起点和终点经纬度。

### Method
GET

### Endpoint
https://restapi.amap.com/v5/direction/bicycling

### Parameters
#### Query Parameters
- **key** (string) - 必填 - 高德Key，用户在高德地图官网申请 Web 服务 API 类型 Key。
- **origin** (string) - 必填 - 起点经纬度，经度在前，纬度在后，经度和纬度用","分割，经纬度小数点后不得超过6位。
- **destination** (string) - 必填 - 目的地，经度在前，纬度在后，经度和纬度用","分割，经纬度小数点后不得超过6位。
- **show_fields** (string) - 可选 - 返回结果控制，用来筛选 response 结果中可选字段。多个字段间采用","进行分割。未设置时只返回基础信息类内字段。
- **alternative_route** (string) - 可选 - 返回方案条数，1：多备选路线中第一条路线，2：多备选路线中前两条路线，3：多备选路线中三条路线，不传则默认返回一条路线方案。
- **sig** (string) - 可选 - 数字签名，请参考数字签名获取和使用方法。
- **output** (string) - 可选 - 返回结果格式类型，可选值：JSON，缺省值为json。
- **callback** (string) - 可选 - 回调函数，callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。

### Request Example
https://restapi.amap.com/v5/direction/bicycling?origin=116.466485,39.995197&destination=116.46424,40.020642&key=<用户的key>

### Response
#### Success Response (200)
- **status** (string) - 本次 API 访问状态，如果成功返回1，如果失败返回0。
- **info** (string) - 访问状态值的说明，如果成功返回"ok"，失败返回错误原因。
- **infocode** (string) - 返回状态说明，10000代表正确。
- **count** (string) - 路径规划方案总数。
- **route** (object) - 返回的规划方案列表。
- **origin** (string) - 起点经纬度。
- **destination** (string) - 终点经纬度。
- **paths** (object) - 算路方案详情。
- **distance** (string) - 方案距离，单位：米。
- **steps** (object) - 路线分段。
- **instruction** (string) - 骑行指示。
- **orientation** (string) - 进入道路方向。
- **road_name** (string) - 分段道路名称。
- **step_distance** (string) - 分段距离信息。
- **cost** (object) - 设置后可返回方案所需时间及费用成本。
- **duration** (string) - 线路耗时，包括方案总耗时及分段step中的耗时，单位：秒。
- **navi** (object) - 设置后可返回详细导航动作指令。
- **action** (string) - 导航主要动作指令。
- **assistant_action** (string) - 导航辅助动作指令。
- **walk_type** (string) - 算路结果中存在的道路类型。
- **polyline** (string) - 设置后可返回分路段坐标点串，两点间用","分隔。

#### Response Example
{
  "status": "1",
  "info": "ok",
  "infocode": "10000",
  "count": "1",
  "route": {
    "origin": "116.466485,39.995197",
    "destination": "116.46424,40.020642",
    "paths": {
      "distance": "1000",
      "steps": {
        "instruction": "骑行指示",
        "orientation": "进入道路方向",
        "road_name": "分段道路名称",
        "step_distance": "分段距离信息"
      }
    }
  }
}
```

--------------------------------

### 调用 start 方法开启拖拽选址

Source: https://lbs.amap.com/api/amap-ui/reference-amap-ui/other/positionpicker

调用 start 方法开始拖拽选点，start 方法可接受一个经纬度参数作为起始点，缺省值为地图中心点。

```JavaScript
positionPicker.start();
```

--------------------------------

### setStart(start)

Source: https://lbs.amap.com/api/subway-api/guide/station-information/station-mark

添加起点标注，用于路线规划。start 为起点站点的 id 或名称。需在地铁图加载完成后调用。

```APIDOC
## setStart(start)

### Description
添加起点标注，用于路线规划。start 为起点站点的 id 或名称。

### Method
setStart

### Parameters
#### start
- **start** (string) - Required - 起点站点的 id 或名称

### Request Example
```javascript
mysubway.setStart(start);
```

### Notes
- 需在地铁图加载完成后调用。
```

--------------------------------

### GET https://restapi.amap.com/v3/direction/driving

Source: https://lbs.amap.com/api/webservice/guide/api/direction

驾车路径规划 API 可以规划以小客车、轿车通勤出行的方案，并返回通勤方案的数据。该接口为 HTTP GET 请求，需要提供起点和终点坐标，并支持多种可选参数以定制路径规划策略。

```APIDOC
## [GET] https://restapi.amap.com/v3/direction/driving

### Description
驾车路径规划 API 可以规划以小客车、轿车通勤出行的方案，并返回通勤方案的数据。

### Method
GET

### Endpoint
https://restapi.amap.com/v3/direction/driving?parameters

### Parameters
#### Query Parameters
- **key** (string) - 必填 - 用户唯一标识，用户在高德地图官网申请。
- **origin** (string) - 必填 - 出发点，经度在前，纬度在后，经度和纬度用","分割，经纬度小数点后不得超过6位。格式为x1,y1|x2,y2|x3,y3。允许传入多个起点用于计算车头角度，最多允许传入3个坐标对，每对坐标之间距离必须超过2m。
- **destination** (string) - 必填 - 目的地，经度在前，纬度在后，经度和纬度用","分割，经纬度小数点后不得超过6位。
- **originid** (string) - 可选 - 出发点 poiid，起点为 POI 时建议填充此值，可提升路线规划准确性。
- **destinationid** (string) - 可选 - 目的地 poiid，当终点为 POI 时建议填充此值。
- **destinationtype** (string) - 可选 - 终点的 poi 类别，当用户知道终点 POI 的类别时候建议填充此值。
- **strategy** (integer) - 可选 - 驾车选择策略，默认值为0。具体策略说明见文档。
- **waypoints** (string) - 可选 - 途经点，经度和纬度用","分割，经度在前，纬度在后，小数点后不超过6位，坐标点之间用";"分隔，最大数目16个坐标点。
- **avoidpolygons** (string) - 可选 - 避让区域，支持32个避让区域，每个区域最多可有16个顶点，经度和纬度用","分割，坐标点之间用";"分隔，区域之间用"|"分隔。
- **province** (string) - 可选 - 用汉字填入车牌省份缩写，用于判断是否限行。
- **number** (string) - 可选 - 填入除省份及标点之外，车牌的字母和数字（需大写），用于判断限行相关。
- **cartype** (integer) - 可选 - 车辆类型，0：普通汽车(默认值)，1：纯电动车，2：插电混动车。
- **ferry** (integer) - 可选 - 在路径规划中是否使用轮渡，0:使用渡轮(默认)，1:不使用渡轮。
- **roadaggregation** (boolean) - 可选 - 是否返回路径聚合信息，false:不返回，true:返回。
- **nosteps** (integer) - 可选 - 是否返回 steps 字段内容，0:正常返回，1:为空。
- **sig** (string) - 可选 - 数字签名，数字签名认证用户必填。
- **output** (string) - 可选 - 返回数据格式类型，可选值：JSON，XML，默认JSON。
- **callback** (string) - 可选 - 回调函数，仅在 output=JSON 时有效。
- **extensions** (string) - 必填 - 返回结果控制，可选值：base/all，base:返回基本信息；all：返回全部信息。

### Request Example
https://restapi.amap.com/v3/direction/driving?origin=116.481028,39.989643&destination=116.465302,40.004717&extensions=all&output=xml&key=<用户的key>

### Response
#### Success Response (200)
响应内容根据 extensions 参数返回基本信息或全部信息，具体字段未在文档中详细说明。

#### Response Example
未提供具体响应示例。
```

--------------------------------

### startSpeak()

Source: https://lbs.amap.com/api/android-navi-sdk/guide/voice/speech-synthesizer

开始内置语音播报，仅在启用内置语音时有效。

```APIDOC
## startSpeak()

### Description
开始内置语音播报，只有在使用内置语音的情况下才有效。

### Method
startSpeak

### Parameters
无

### Notes
- 从6.4.0版本开始提供。
- 属于AMapNavi类的方法。
```

--------------------------------

### 引入AMapFoundationKit和AMapLocationKit头文件 (Swift)

Source: https://lbs.amap.com/api/ios-location-sdk/guide/get-location/backgroundlocation

在桥接文件中引入头文件，用于Swift项目。

```Swift
//在桥接文件中引入头文件
#import <AMapFoundationKit/AMapFoundationKit.h>

#import <AMapLocationKit/AMapLocationKit.h>
```

--------------------------------

### GET /v3/place/text

Source: https://lbs.amap.com/api/webservice/guide/api-advanced/search

关键字搜索 API 服务地址，通过 GET 请求发送参数进行搜索。支持关键字或 POI 类型搜索，并可指定城市、分页等参数。

```APIDOC
## [GET] /v3/place/text

### Description
关键字搜索 API 服务地址，通过 GET 请求发送参数进行搜索。支持关键字或 POI 类型搜索，并可指定城市、分页等参数。

### Method
GET

### Endpoint
https://restapi.amap.com/v3/place/text?parameters

### Parameters
#### Query Parameters
- **key** (string) - Required - 请求服务权限标识，用户在高德地图官网申请 Web 服务 API 类型 KEY。
- **keywords** (string) - Required (keyword 或者 types 二选一必填) - 查询关键字，只支持一个关键字。若不指定 city，并且搜索的为泛词（例如“美食”）的情况下，返回的内容为城市列表以及此城市内有多少结果符合要求。
- **types** (string) - Required (keyword 或者 types 二选一必填) - 查询 POI 类型，可选值：分类代码或汉字。多个关键字用“|”分割。分类代码由六位数字组成，分为三个部分。若指定了某个大类，则所属的中类、小类都会被显示。
- **city** (string) - Optional - 查询城市，可选值：城市中文、citycode、adcode。填入此参数后，会尽量优先返回此城市数据，但不一定仅局限此城市结果。
- **citylimit** (boolean) - Optional - 仅返回指定城市数据，可选值：true/false。
- **children** (integer) - Optional - 是否按照层级展示子 POI 数据，可选值：children=1。当为0的时候，子 POI 都会显示；当为1的时候，子 POI 会归类到父 POI 之中。在 extensions=all 或者为空时生效。
- **offset** (integer) - Optional - 每页记录数据，强烈建议不超过25，若超过25可能造成访问报错。
- **langCode** (string) - Optional - 返回结果语言，默认：zh（中文），可选：en（英文）。
- **page** (integer) - Optional - 当前页数。
- **extensions** (string) - Optional - 返回结果控制，默认返回基本地址信息；取值为 all 返回地址信息、附近 POI、道路以及道路交叉口信息。
- **sig** (string) - Optional - 数字签名。
- **callback** (string) - Optional - 回调函数，callback 值是用户定义的函数名称，此参数只在 output=JSON 时有效。

### Request Example
https://restapi.amap.com/v3/place/text?keywords=北京大学&city=beijing&offset=20&page=1&key=<用户的key>&extensions=all

### Response
#### Success Response (200)
- **status** (string) - 结果状态值，值为0或1。0：请求失败；1：请求成功。
- **info** (string) - 返回状态说明，status 为0时，info 返回错误原因，否则返回“OK”。
- **count** (string) - 搜索方案数目。
- **suggestion** (object) - 城市建议列表，当搜索的文本关键字在限定城市中没有返回时会返回建议城市列表。
- **pois** (array) - 搜索 POI 信息列表。

#### Response Example
{
  "status": "1",
  "info": "OK",
  "count": "1",
  "suggestion": {
    "keywords": "北京大学",
    "cities": [
      {
        "name": "北京市",
        "num": "1",
        "citycode": "010",
        "adcode": "110000"
      }
    ]
  },
  "pois": [
    {
      "id": "B000A8UIN8",
      "parent": "",
      "name": "北京大学",
      "type": "科教文化服务;学校;大学",
      "typecode": "141201",
      "biz_type": "",
      "address": "颐和园路5号",
      "location": "116.310003,39.991957",
      "distance": [],
      "tel": "010-62752114",
      "postcode": "100871",
      "website": "www.pku.edu.cn",
      "email": "",
      "pcode": "110000",
      "pname": "北京市",
      "citycode": "010",
      "cityname": "北京市",
      "adcode": "110108",
      "adname": "海淀区",
      "entr_location": "116.308419,39.992911",
      "exit_location": [],
      "navi_poiid": "",
      "gridcode": "",
      "alias": "",
      "parking_type": "",
      "tag": "",
      "indoor_map": "0",
      "indoor_data": [],
      "cpid": "B000A8UIN8",
      "floor": "",
      "truefloor": "",
      "groupbuy_num": "0",
      "business_area": "",
      "atag": "",
      "discount_num": "0",
      "biz_ext": {
        "rating": "",
        "cost": ""
      },
      "photos": []
    }
  ]
}
```

--------------------------------

### searchPOI command usage and example

Source: https://lbs.amap.com/api/cli/map-cli/reference

Shows the 'amap-gui searchPOI' command options and a usage example with its JSON response. The command requires --keyword; --city is optional. The example searches for 星巴克 in 北京 with pageSize 1.

```bash
# amap-gui searchPOI [options]  类型      是否必传   描述
# --json '<JSON>'              string    No        完整 JSON 输入（优先级最高）
# --keyword <text>             string    Yes       搜索关键词
# --city <city>                string    No        搜索城市
# --center <lng,lat>           lng,lat   No        周边搜索中心坐标（仅支持坐标格式）
# --radius <meters>            number    No        搜索半径（米），默认 3000
# --pageSize <n>               number    No        每页数量，默认 10
# --pageIndex <n>              number    No        页码，默认 1

# exmaple
amap-gui searchPOI --keyword 星巴克 --city 北京 --pageSize 1
```

```json
# 返回结果

# {
#   "success": true,
#   "data": {
#     "state": {
#       "keyword": "星巴克",
#       "pageSize": 1,
#       "pageIndex": 1,
#       "extensions": "all",
#       "resultCount": 600,
#       "city": "北京"
#     },
#     "pois": [
#       {
#         "id": "B0FFJGCM9X",
#         "name": "星巴克(京汇大厦店)",
#         "type": "餐饮服务;咖啡厅;星巴克咖啡",
#         "location": [
#           116.462991,
#           39.906998
#         ],
#         "address": "北京城区建国路乙118号京汇大厦一层1-105号单元",
#         "distance": null,
#         "tel": "010-65685868",
#         "pname": "北京市",
#         "cityname": "北京市",
#         "adname": "朝阳区",
#         "photo": "https://store.is.autonavi.com/showpic/6e458084419d9144d0b5f1020d7958f0"
#       }
#     ],
#     "total": 600,
#     "pageIndex": 1,
#     "pageSize": 1
#   },
#   "error": null
# }
```

--------------------------------

### 安装 SDK 命令

Source: https://lbs.amap.com/api/ios-location-sdk/guide/create-project/cocoapods

在 Podfile 目录下执行这两条命令来配置并安装 SDK。pod repo update 保证本地地图相关 SDK 为最新版，pod install 安装依赖。注意 pod 'AMapLocation' 会引入基础 SDK，影响 AppStore 提交。

```bash
pod repo update  #用于保证本地地图相关SDK为最新版
pod install
```

--------------------------------

### BasicControl Usage Example

Source: https://lbs.amap.com/api/amap-ui/reference-amap-ui/control/basiccontrol

Example of loading the BasicControl module and adding Zoom, LayerSwitcher, and Traffic controls to a map.

```APIDOC
## BasicControl Usage

### Description
Example of loading the BasicControl module and adding Zoom, LayerSwitcher, and Traffic controls to a map.

### Code
```javascript
//设置DomLibrary，jQuery或者Zepto
AMapUI.setDomLibrary($);

//加载BasicControl，loadUI的路径参数为模块名中 'ui/' 之后的部分
AMapUI.loadUI(['control/BasicControl'], function(BasicControl) {

  var map = new AMap.Map('container');

  //缩放控件
  map.addControl(new BasicControl.Zoom({
      position: 'lt', //left top，左上角
      showZoomNum: true //显示zoom值
  }));

  //图层切换控件
  map.addControl(new BasicControl.LayerSwitcher({
      position: 'rt' //right top，右上角
  }));

  //实时交通控件
  map.addControl(new BasicControl.Traffic({
      position: 'lb'//left bottom, 左下角
  }));
});
```
```

--------------------------------

### 模拟导航：calculateDriveRoute和startNavi

Source: https://lbs.amap.com/api/android-navi-sdk/summary

用于模拟导航，设置起点、终点和途经点，计算驾驶路线并启动模拟导航。需在onInitNaviSuccess中调用calculateDriveRoute，在onCalculateRouteSuccess中调用startNavi(NaviType.EMULATOR)。

```java
protected NaviLatLng mEndLatlng = new NaviLatLng(40.084894,116.603039);
protected NaviLatLng mStartLatlng = new NaviLatLng(39.825934,116.342972);
protected final List<NaviLatLng> sList = new ArrayList<NaviLatLng>();
protected final List<NaviLatLng> eList = new ArrayList<NaviLatLng>();
protected List<NaviLatLng> mWayPointList = new ArrayList<NaviLatLng>();
@Override
public void onInitNaviSuccess() {
	super.onInitNaviSuccess();
	sList.add(mStartLatlng);
	eList.add(mEndLatlng);
	int strategy = 0;
	strategy = mAMapNavi.strategyConvert(true, false, false, false, false);
	AMapCarInfo carInfo = new AMapCarInfo();
	mAMapNavi.calculateDriveRoute(sList, eList, mWayPointList, strategy);
} 
@Override
public void onCalculateRouteSuccess(AMapCalcRouteResult aMapCalcRouteResult) {
	super.onCalculateRouteSuccess(aMapCalcRouteResult);
	mAMapNavi.startNavi(NaviType.EMULATOR);
}
```

--------------------------------

### getLastEvent command and example outputs

Source: https://lbs.amap.com/api/cli/map-cli/reference

Shows the 'amap-gui getLastEvent' command and two example JSON responses. The command takes no parameters and returns the last map interaction event. The first example shows a map_click event, the second a poi_click event.

```bash
amap-gui getLastEvent
```

```json
# example1
#{
#   "success": true,
#   "data": {
#     "lastEvent": {
#       "hasEvent": true,
#       "type": "map_click",
#       "position": [
#         116.462574,
#         39.907429
#       ]
#     }
#   },
#   "error": null
# }
```

```json
# example2
# {
#   "success": true,
#   "data": {
#     "lastEvent": {
#       "hasEvent": true,
#       "type": "poi_click",
#       "title": "星巴克(京汇大厦店)",
#       "address": "北京城区建国路乙118号京汇大厦一层1-105号单元",
#       "position": [
#         116.462991,
#         39.906998
#       ]
#     }
#   },
#   "error": null
# }
```

--------------------------------

### 安装指定版本 SDK 命令

Source: https://lbs.amap.com/api/ios-location-sdk/guide/create-project/cocoapods

修改 Podfile 后，执行这两条命令安装指定版本的 SDK。pod repo update 保证本地仓库最新，pod install 安装依赖。

```bash
pod repo update #用于保证本地地图相关SDK为最新版
pod install
```

--------------------------------

### - (void)setNeedCalculateRouteWhenPresent:(BOOL)need

Source: https://lbs.amap.com/api/ios-navi-sdk/guide/navi-component/advanced-functions

设置导航组件启动时是否需要进行路径规划。此设置只有在setStartNaviDirectly为YES时，才起作用。常用于已使用AMapNaviDriveManager规划好路线，只想使用导航组件导航界面的场景。

```APIDOC
## setNeedCalculateRouteWhenPresent:

### Description
设置导航组件启动时，是否需要进行路径规划。此设置只有在setStartNaviDirectly为YES时，才起作用。

### Method
- (void)setNeedCalculateRouteWhenPresent:(BOOL)need

### Parameters
- **need** (BOOL) - 是否需要进行路径规划，默认为YES。如果为NO，导航组件启动时将不再进行算路，直接使用 AMapNaviDriveManager 单例已经规划好的路径进行导航。

### Availability
since 5.4.0
```

--------------------------------

### calculateEleBikeRoute(NaviPoi fromPoi, NaviPoi toPoi, TravelStrategy strategy)

Source: https://lbs.amap.com/api/android-navi-sdk/guide/route-plan/electric-route-plan

Performs electric bike route planning with start and end POIs and a travel strategy. The start POI can be null, in which case the current location is used as the start. Returns a boolean indicating whether the parameters and conditions for route planning are valid, not whether the route calculation succeeded.

```APIDOC
## calculateEleBikeRoute(NaviPoi fromPoi, NaviPoi toPoi, TravelStrategy strategy)

### Description
Performs electric bike route planning with start and end POIs and a travel strategy. The start POI can be null, in which case the current location is used as the start. Returns a boolean indicating whether the parameters and conditions for route planning are valid, not whether the route calculation succeeded.

### Method
calculateEleBikeRoute

### Parameters
- **fromPoi** (NaviPoi) - Optional - The start POI. Can be null to use the current location.
- **toPoi** (NaviPoi) - Required - The destination POI.
- **strategy** (TravelStrategy) - Required - The route calculation strategy (e.g., SINGLE, MULTIPLE).

### Returns
- **BOOL** - Indicates whether the route planning conditions and parameter validation succeeded, not whether the route calculation succeeded.

### Request Example (Single Path)
```java
NaviPoi start = new NaviPoi("故宫博物馆", null, "B000A8UIN8");
NaviPoi end = new NaviPoi("北京大学", null, "B000A816R6");
AMapNavi.getInstance(this).calculateEleBikeRoute(start, end, TravelStrategy.SINGLE);
```

### Request Example (Multiple Paths)
```java
NaviPoi start = new NaviPoi("故宫博物馆", null, "B000A8UIN8");
NaviPoi end = new NaviPoi("北京大学", null, "B000A816R6");
AMapNavi.getInstance(this).calculateEleBikeRoute(start, end, TravelStrategy.MULTIPLE);
```
```

--------------------------------

### 升级 SDK 命令

Source: https://lbs.amap.com/api/ios-location-sdk/guide/create-project/cocoapods

在 Podfile 目录下执行这两条命令将 SDK 更新到最新版本。pod update 会连带更新基础 SDK，影响 AppStore 提交。

```bash
pod repo update #用于保证本地地图相关SDK为最新版
pod update
```

--------------------------------

### 通过Android Studio获取SHA1 - keytool命令

Source: https://lbs.amap.com/api/android-location-sdk/guide/create-project/get-key

在Android Studio的Terminal中执行此命令，输入keystore文件路径后按提示输入Keystore密码，即可获取SHA1值。

```bash
keytool -v -list -keystore keystore 文件路径
```
Tokens:
Raw