Expo大作战(三十五)--expo sdk api之Location！

简要：本系列文章讲会对expo进行全面的介绍，本人从2017年6月份接触expo以来，对expo的研究断断续续，一路走来将近10个月，废话不多说，接下来你看到内容，讲全部来与官网

我猜去全部机翻+个人修改补充+demo测试的形式，对expo进行一次大补血！欢迎加入expo兴趣学习交流群：597732981

【之前我写过一些列关于expo和rn入门配置的东i西，大家可以点击这里查看：从零学习rn开发】

相关文章：

Expo大作战(一)--什么是expo，如何安装expo clinet和xde，xde如何使用

Expo大作战(二)--expo的生命周期，expo社区交流方式，expo学习必备资源，开发使用expo时关注的一些问题

Expo大作战(三)--针对已经开发过react native项目开发人员有针对性的介绍了expo，expo的局限性，开发时项目选型注意点等

Expo大作战(四)--快速用expo构建一个app，expo中的关键术语

Expo大作战(五)--expo中app.json 文件的配置信息

Expo大作战(六)--expo开发模式，expo中exp命令行工具，expo中如何查看日志log，expo中的调试方式

Expo大作战(七)--expo如何使用Genymotion模拟器

Expo大作战(八)--expo中的publish以及expo中的link，对link这块东西没有详细看，大家可以来和我交流

更多>>

写在二十三章以后的话，之前的翻译，不管如何，好与不好，终究是告一段落，也把expo基础理论的东西又深入的理解了一遍，后续expo大作战系列将主要介绍expo sdk的api。

---

位置Location

该模块允许从设备读取地理位置信息。 您的应用可以轮询当前位置或订阅位置更新事件。

在尝试获取之前，您必须先获得访问用户位置的权限。 为此，您需要使用Permissions API。 在下面的例子中你可以看到这一点。

Expo.Location.getCurrentPositionAsync（options）

获取设备的当前位置。

参数

option(object） -

选项图：

• enableHighAccuracy（boolean） - 是否启用高精度模式。对于低精度的实施可以避免消耗大量功率的地理位置提供商（如GPS）。
• maximumAge（数字） - （仅限Android）。如果指定，则允许以毫秒为单位返回先前缓存的最旧位置。如果未指定，则始终获取新位置。在iOS上，此选项将被忽略，并且总是返回新的位置。

返回

返回包含以下字段的对象：

coords（对象） - 位置的坐标，包含以下字段：

• latitude (number)  - 以度为单位的纬度。
• longitude (number) - 以度为单位的经度。
• altitude (number)  - WGS 84参考椭球面以上的高度（米）。
• accuracy (number) - 位置的不确定性半径，以米为单位。
• altitudeAccuracy（number） - 海拔高度值的准确度，单位为米（仅限iOS）。
• heading (number)） - 此设备的水平行进方向，以度为单位开始测量，以正北为单位并沿指南针顺时针方向继续。因此，北部是0度，东部是90度，南部是180度，依此类推。
• speed (number) - 设备的瞬时速度，单位为米/秒。

timestamp (number) - 获取此位置信息的时间，以时间为单位，以毫秒为单位。

Expo.Location.watchPositionAsync(options, callback)

从设备订阅位置更新。请注意，更新只会在应用程序处于前台时发生。背景位置跟踪计划中，但尚未实施。

参数

options（object） -

选项图：

• enableHighAccuracy（boolean） - 是否启用高精度模式。对于低精度的实施可以避免消耗大量功率的地理位置提供商（如GPS）。
• timeInterval（number） - 每次更新之间以毫秒为单位等待的最短时间。
• distanceInterval（number） - 仅当位置以米为单位改变至少该距离时才接收更新。

callback（function） -

每个位置更新都会调用此函数。它只传递一个参数：包含以下字段的对象：

coords（对象） - 位置的坐标，包含以下字段：

• latitude (number)  - 以度为单位的纬度。
• longitude (number) - 以度为单位的经度。
• altitude (number)  - WGS 84参考椭球面以上的高度（米）。
• accuracy (number) - 位置的不确定性半径，以米为单位。
• altitudeAccuracy（number） - 海拔高度值的准确度，单位为米（仅限iOS）。
• heading (number)） - 此设备的水平行进方向，以度为单位开始测量，以正北为单位并沿指南针顺时针方向继续。因此，北部是0度，东部是90度，南部是180度，依此类推。
• speed (number) - 设备的瞬时速度，单位为米/秒。

timespan(number) - 获取此位置信息的时间，以时间为单位，以毫秒为单位。
返回

返回具有一个字段的订阅对象：

• remove（function） - 不带任何参数调用此函数来删除此订阅。该回调将不再被称为位置更新。

Expo.Location.getProviderStatusAsync（）
检查位置提供者的状态。

返回

返回包含以下字段的对象：

• locationServicesEnabled（boolean） - 是否启用位置服务。
• gpsAvailable（boolean）（仅限android） - 如果GPS提供者可用，如果是，则位置数据将来自GPS。
• networkAvailable（boolean）（仅限android） - 如果网络提供者可用，如果是，则位置数据将来自蜂窝网络。
• passiveAvailable（boolean）（仅限android） - 如果被动提供者可用，如果是，则位置数据将被动地确定。

Expo.Location.getHeadingAsync()

从设备获取当前的朝向信息

参数

没有

返回

对象：

• magHeading（数字） - 以度为单位的磁北测量
• trueHeading（number） - 衡量真正的北方度（需要位置权限，如果没有给出则返回-1）
• 准确度（数字） - 指南针的校准程度。
  • 　　3：高精度，2：中等精度，1：低精度，0：无
  • 　　IOS参考：3：<20度不确定度，2：<35度，1：<50度，0：> 50度

Expo.Location.watchHeadingAsync(callback)

指定从设备指南针更新

参数

callback(function) -

每个指南针更新都会调用该函数。它只传递一个参数：包含以下字段的对象：

• magHeading（数字） - 以度为单位的磁北测量
• trueHeading（number） - 衡量真正的北方度（需要位置权限，如果没有给出则返回-1）
• accuracy (number)  - 指南针的校准程度。
  • 　　3：高精度，2：中等精度，1：低精度，0：无
  • 　　iOS参考：3：<20度不确定度，2：<35度，1：<50度，0：> 50度

返回

返回具有一个字段的订阅对象：

remove（function） - 不带任何参数调用此函数来删除此订阅。该回调将不再被称为位置更新。

Expo.Location.geocodeAsync(address)

将地址字符串编码到经纬度位置。

注意：地理编码消耗资源，必须合理使用。一次创建太多请求可能会导致错误，因此必须对其进行正确管理。

在Android上，您必须在使用地理编码之前向用户请求位置权限（Expo.Permissions.LOCATION）。
参数

adress(string) - 表示地址的字符串，例如。 “贝克街伦敦”（address (string) — A string representing address, eg. “Baker Street London”）
返回

返回经过地理编码的位置对象的数组（大多数情况下其大小为1），并包含以下字段：

latitude (number) - 以度为单位的纬度。
longitude (number) - 以度为单位的经度。
altitude (number)  - WGS 84参考椭球面以上的高度（米）。
accuracy (number) - 位置的不确定性半径，以米为单位。

Expo.Location.reverseGeocodeAsync(location)

将地址解析为邮政地址。

注意：地理编码消耗资源，必须合理使用。一次创建太多请求可能会导致错误，因此必须对其进行正确管理。
在Android上，您必须在使用地理编码之前向用户请求位置权限（Expo.Permissions.LOCATION）。
参数

location（object）- 表示位置的对象：

• latitude (number)  - 反转地理代码的位置的纬度，以度为单位。
• longitude (number) - 反转地理代码的位置的经度，以度为单位。

返回

返回包含以下字段的地址对象的数组（大多数情况下其大小为1）：

• city (string) 城市（字符串） - 地址的城市名称。
• street (string) 街道（字符串） - 地址的街道名称。
• region (string)  区域（字符串） - 地址的区域/区域名称。
• postalCode (string) 邮政编码（字符串） - 地址的邮政编码。
• country (string) 国家（字符串） - 地址的国家/地区名称。
• name (string) 名称（字符串） - 地址的名称，例如“塔桥”。

Expo.Location.setApiKey（apiKey）

设置Google API密钥以使用地理编码API。此方法对于没有Google Play服务的Android设备非常有用，因此无需Geocoder服务。使用Google的API设置密钥之后就可以了。

参数

apiKey（string） - 从Google开发者网站收集的API密钥。

---

下一张继续介绍，这一篇主要介绍了：expo sdk api之Location！，欢迎大家关注我的微信公众号，这篇文章是否被大家认可，我的衡量标准就是公众号粉丝增长人数。欢迎大家转载，但必须保留本人博客链接！