@warpsoft/geolocation

基于百度地图位置服务的定位插件

Install

npm install @warpsoft/geolocation
npx cap sync

iOS

Apple 需要在Info.plist文件中指定获取位置隐私的描述

• NSLocationAlwaysUsageDescription (Privacy - Location Always Usage Description)
• NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)

百度地图 需要在Info.plist文件中指定 key

• BMKLocationKey 2LiwwO3SQoYOSoF1lYwAdpc8TkauXpki

Android

百度地图 需要在 AndroidMenifest.xml 中指定 key

  <application>
    ...
+    <meta-data
+      android:name="com.baidu.lbsapi.API_KEY"
+      android:value="2LiwwO3SQoYOSoF1lYwAdpc8TkauXpki" >
+    </meta-data>
    ...
  </application>

API

• getCurrentLocation(...)
• watchLocation(...)
• watchStatus()
• clearWatch()
• Interfaces

getCurrentLocation(...)

getCurrentLocation(options: requestOptions) => Promise<Position>

获取当前位置信息

| Param | Type | Description | | ------------- | --------------------------------------------------------- | ----------- | | options | requestOptions | 请求位置信息的选项 |

Returns: Promise<Position>

watchLocation(...)

watchLocation(options: requestOptions, callback: Function) => Promise<void>

连续获取位置信息

| Param | Type | Description | | -------------- | --------------------------------------------------------- | ----------- | | options | requestOptions | 请求位置信息的选项 | | callback | Function | 处理位置信息的回调函数 |

watchStatus()

watchStatus() => Promise<Status>

获取监视状态

Returns: Promise<Status>

clearWatch()

clearWatch() => Promise<void>

清除位置监视

Interfaces

Position

当前位置信息

| Prop | Type | Description | | ------------ | --------------------------------------------------- | ----------- | | time | string | 获取时间 | | coords | Coordinates | 坐标信息 | | addr | Address | 地址信息 |

Coordinates

地理坐标详细信息

| Prop | Type | Description | | --------------- | ------------------- | ----------- | | latitude | number | 经度 | | longitude | number | 纬度 | | altitude | number | 高度 | | speed | number | 速度 | | direction | number | 方向 | | radius | number | 半径 |

Address

地址中文详细信息

| Prop | Type | Description | | -------------- | ------------------- | ----------- | | country | string | 国家 | | adcode | string | 地区编码 | | province | string | 省 | | city | string | 市 | | district | string | 区 | | street | string | 街道 | | address | string | 地址描述 | | town | string | 村镇 |

requestOptions

请求位置信息的选项

| Prop | Type | Description | | ------------------- | -------------------- | ----------- | | withReGeocode | boolean | 是否携带地址详细信息 |

Function

Creates a new function.

| Prop | Type | | --------------- | --------------------------------------------- | | prototype | any | | length | number | | arguments | any | | caller | Function |

| Method | Signature | Description | | ------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | apply | (this: Function, thisArg: any, argArray?: any) => any | Calls the function, substituting the specified object for the this value of the function, and the specified array for the arguments of the function. | | call | (this: Function, thisArg: any, ...argArray: any[]) => any | Calls a method of an object, substituting another object for the current object. | | bind | (this: Function, thisArg: any, ...argArray: any[]) => any | For a given function, creates a bound function that has the same body as the original function. The this object of the bound function is associated with the specified object, and has the specified initial parameters. | | toString | () => string | Returns a string representation of a function. |

Status

位置监视状态

| Prop | Type | Description | | -------------- | -------------------- | ---------------------------- | | watching | boolean | 是否正在监视 | | id | string | 监视id 可用来 clearWatch 停止监视位置信息 |