@justwei/capacitor-location

justwei location plugin

Install

npm install @justwei/capacitor-location
npx cap sync

API

• getCurrentPosition(...)
• checkPermissions()
• requestPermissions(...)
• Interfaces
• Type Aliases

定义插件接口，描述插件的方法和返回类型

getCurrentPosition(...)

getCurrentPosition(options?: PositionOptions | undefined) => Promise<Position>

获取当前设备的GPS位置

| Param | Type | Description | | ------------- | ----------------------------------------------------------- | ----------- | | options | PositionOptions | 定位选项 |

Returns: Promise<Position>

checkPermissions()

checkPermissions() => Promise<PermissionStatus>

检查位置权限。如果系统位置服务被禁用，将会抛出异常。

Returns: Promise<PermissionStatus>

requestPermissions(...)

requestPermissions(permissions?: GeolocationPluginPermissions | undefined) => Promise<PermissionStatus>

请求位置权限。如果系统位置服务被禁用，将会抛出异常。

| Param | Type | | ----------------- | ------------------------------------------------------------------------------------- | | permissions | GeolocationPluginPermissions |

Returns: Promise<PermissionStatus>

Interfaces

Position

| Prop | Type | Description | Since | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ----- | | timestamp | number | 坐标的创建时间戳 | 1.0.0 | | coords | { latitude: number; longitude: number; accuracy: number; altitudeAccuracy: number | null; altitude: number | null; speed: number | null; heading: number | null; source?: 'gps' | 'network' | 'passive' | 'unknown'; fromCache?: boolean; timedOut?: boolean; } | The GPS coordinates along with the accuracy of the data | |

PositionOptions

| Prop | Type | Description | Default | Since | | --------------------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----- | | enableHighAccuracy | boolean | High accuracy mode (such as GPS, if available) On Android 12+ devices it will be ignored if users didn't grant ACCESS_FINE_LOCATION permissions (can be checked with location alias). | false | 1.0.0 | | timeout | number | The maximum wait time in milliseconds for location updates. In Android, since version 4.0.0 of the plugin, timeout gets ignored for getCurrentPosition. | 10000 | 1.0.0 | | maximumAge | number | The maximum age in milliseconds of a possible cached position that is acceptable to return | 0 | 1.0.0 | | minimumUpdateInterval | number | The minumum update interval for location updates. If location updates are available faster than this interval then an update will only occur if the minimum update interval has expired since the last location update. This parameter is only available for Android. It has no effect on iOS or Web platforms. | 5000 | 6.1.0 |

PermissionStatus

| Prop | Type | Description | Since | | -------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----- | | location | PermissionState | Permission state for location alias. On Android it requests/checks both ACCESS_COARSE_LOCATION and ACCESS_FINE_LOCATION permissions. On iOS and web it requests/checks location permission. | 1.0.0 | | coarseLocation | PermissionState | Permission state for coarseLocation alias. On Android it requests/checks ACCESS_COARSE_LOCATION. On Android 12+, users can choose between Approximate location (ACCESS_COARSE_LOCATION) or Precise location (ACCESS_FINE_LOCATION), so this alias can be used if the app doesn't need high accuracy. On iOS and web it will have the same value as location alias. | 1.2.0 |

GeolocationPluginPermissions

| Prop | Type | | ----------------- | ---------------------------------------- | | permissions | GeolocationPermissionType[] |

Type Aliases

PermissionState

'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'

GeolocationPermissionType

'location' | 'coarseLocation'