`
samwong
  • 浏览: 286973 次
  • 性别: Icon_minigender_1
  • 来自: 北京
社区版块
存档分类
最新评论

PhoneGap API帮助文档翻译—Geolocation（地理位置） PhoneGap API帮助文档翻译—Geolocation（地理位置）

 
阅读更多

PhoneGap API帮助文档翻译—Geolocation（地理位置）

“ geolocation对象提供了对设备GPS传感器的访问。
Geolocation提供设备的位置信息，例如经度和纬度。位置信息的常见来源包括全球定位系统（GPS），以及通过诸如IP地址、RFID、WiFi和蓝牙的MAC地址、和GSM/CDMA手机ID的网络信号所做的推断。不能保证该API返回的是设备的真实位置信息。
这个API是基于W3C Geo location API Specification实现的。有些设备已经提供了对该规范的实现，对于这些设备采用内置实现而非使用PhoneGap的实现。对于没有地理位置支持的设备，PhoneGap的实现应该是完全兼容W3C规范。
方法：
  • geolocation.getCurrentPosition
  • geolocation.watchPosition
  • geolocation.clearWatch
参数：
  • geolocationSuccess
  • geolocationError
  • geolocationOptions
对象(只读)：
  • Position
  • PositionError
  • Coordinates
geolocation.getCurrentPosition
返回一个Position对象表示设备的当前位置。
参数：
  • geolocationSuccess：获取位置信息成功时调用的回调函数，参数为当前的位置信息。
  • geolocationError：（可选项）获取位置信息出错时调用的回调函数。
  • geolocationOptions：（可选项）地理位置选项。
说明：
geolocation.getCurrentPositon是一个异步函数。它回传一个包含设备当前位置信息的Position对象给geolocationSuccess回调函数。如果发生错误，触发geolocationError回调函数并传递一个PositionError对象。
支持的平台：
  • Android
  • BlackBerry (OS 4.6)
  • BlackBerry WebWorks (OS 5.0或更高版本)
  • iPhone
简单的范例：
完整的范例：
geolocation.watchPosition
监视设备的当前位置的变化。
参数：
  • geolocationSuccess： 获取位置信息成功时调用的回调函数，参数为当前位置信息。
  • geolocationError：（可选项）获取位置信息出错时调用的回调函数。
  • geolocationOptions：（可选项）地理位置选项。
返回值：
  • String：返回的watch id是位置监视String：返回的watch id是位置监视周期的引用。可以通过geolocation.clearWatch调用该watch ID以停止对位置变化的监视。
说明：
geolocation.watchPosition是一个异步函数。当检测到设备的位置发生改变时，它返回设备的当前位置。当设备检索到一个新的位置，会触发geolocationSuccess回调函数并传递一个Position对象作为参数。如果发生错误，会触发geolocationError回调函数并传递一个PositionError对象。
支持的平台：
  • Android
  • BlackBerry (OS 4.6)
  • BlackBerry WebWorks (OS 5.0或更高版本)
  • iPhone
简单的范例：
完整的范例：
geolocation.clearWatch
停止watchID参数指向的设备位置变化监视。
参数：
  • watchID：要清除的watchPosition周期的id。（字符串类型）
说明：
geolocation.clearWatch函数通过清除watchID指向的geolocation.watchPosition来停止对设备位置变化的监视。
支持的平台：
  • Android
  • BlackBerry (OS 4.6)
  • BlackBerry WebWorks (OS 5.0或更高版本)
  • iPhone
简单的范例：
完整的范例：
geolocationSuccess
当得到一个有效地理位置信息时，此用户回调函数被调当获得一个地理位置信息时，此用户回调函数被调用。
参数：
  • position：设备返回的地理位置信息。（Position类型）
范例：
geolocationError
当geolocation函数发生错误时，此用户回调函数被调用。
参数：
  • error：设备返回的错误信息。（PositionError类型）
geolocationOptions
用户定制地理位置检索的可选参数。
选项：
  • frequency：以毫秒为单位的检索位置周期。这个选项并非W3C规范的一部分，未来会被删除并用maximumAge来替代该选项。（数字类型）（默认值：10000）
  • enableHighAccuracy：提供一个表明应用程序希望获得最佳可能结果的提示。（布尔类型）
  • timeout：允许的以毫秒为单位的最大时间间隔，该时间间隔是从geolocation.getCurrentPosition或geolocation.watchPosition的调用到相应的geolocationSuccess回调函数被调用。（数字类型）
  • maximumAge：应用程序将接受一个缓存的位置信息，当该缓存的位置信息的年龄不大于此参数设定值，单位是毫秒。（数字类型）
Android的特异情况：
除非enableHighAccuracy选项被设定为true，否则Android 2.X模拟器不会返回一个地理位置结果。
Position
包含由geolocation API创建的Position坐标信息。
属性：
  • coords：一系列地理坐标。（Coordinates类型）
  • timestamp：以毫秒为单位的coords的创建时间戳。（DOMTimeStamp类型）
说明：
Position对象是由PhoneGap创建和填充的，并通过一个回调函数返回用户。
支持的平台：
  • Android
  • BlackBerry (OS 4.6)
  • BlackBerry WebWorks (OS 5.0或更高版本)
  • iPhone
简单的范例：
完整的范例：
iPhone的特异情况：
  • timestamp：单位为秒而非毫秒。
一种变通方法是手动将时间戳转换为毫秒（*1000）：
PositionError
当发生错误时，一个PositionError对象会传递给geolocationError回调函数。
属性：
  • code：一个在下面常量列表中定义的错误代码。
  • message：说明错误细节的错误信息。
常量：
  • PositionError.PERMISSIONPositionError.PERMISSION_DENIED：权限被拒绝
  • PositionError.POSITION_UNAVAILABLE：位置不可用
  • PositionError.TIMEOUT：超时
说明：
当使用Geolocation发生错误时，一个PositionError对象会作为geolocationError回调函数的参数传递给用户。
Coordinates
一系列用来描述位置的地理坐标信息的属性。
属性：
  • latitude：以十进制表示的纬度。（数字类型）
  • longitude：以十进制表示的经度。（数字类型）
  • altitude：位置相对于椭圆球面的高度，单位为米。（数字类型）
  • accuracy：以米为单位的纬度和经度坐标的精度水平。（数字类型）
  • altitudeAccuracy：以米为单位的高度坐标的精度水平。（数字类型）
  • heading：运动的方向，通过相对正北做顺时针旋转的角度指定。（数字类型）
  • speed：以米/秒为单位的设备当前地面速度。（数字类型）
说明：
作为Position对象的一部分，Coordinates对象是由PhoneGap创建和填充的。该Position对象会作为一个回调函数的参数返回用户。
支持的平台：
  • Android
  • BlackBerry (OS 4.6)
  • BlackBerry WebWorks (OS 5.0或更高版本)
  • iPhone
简单的范例：
完整的范例：
Android的特异情况：
altitudeAccuracy： Android设备上不支持该属性，返回值总是null。
“ geolocation对象提供了对设备GPS传感器的访问。
Geolocation提供设备的位置信息，例如经度和纬度。位置信息的常见来源包括全球定位系统（GPS），以及通过诸如IP地址、RFID、WiFi和蓝牙的MAC地址、和GSM/CDMA手机ID的网络信号所做的推断。不能保证该API返回的是设备的真实位置信息。
这个API是基于W3C Geo location API Specification实现的。有些设备已经提供了对该规范的实现，对于这些设备采用内置实现而非使用PhoneGap的实现。对于没有地理位置支持的设备，PhoneGap的实现应该是完全兼容W3C规范。
方法：
  • geolocation.getCurrentPosition
  • geolocation.watchPosition
  • geolocation.clearWatch
参数：
  • geolocationSuccess
  • geolocationError
  • geolocationOptions
对象(只读)：
  • Position
  • PositionError
  • Coordinates
geolocation.getCurrentPosition
返回一个Position对象表示设备的当前位置。
参数：
  • geolocationSuccess：获取位置信息成功时调用的回调函数，参数为当前的位置信息。
  • geolocationError：（可选项）获取位置信息出错时调用的回调函数。
  • geolocationOptions：（可选项）地理位置选项。
说明：
geolocation.getCurrentPositon是一个异步函数。它回传一个包含设备当前位置信息的Position对象给geolocationSuccess回调函数。如果发生错误，触发geolocationError回调函数并传递一个PositionError对象。
支持的平台：
  • Android
  • BlackBerry (OS 4.6)
  • BlackBerry WebWorks (OS 5.0或更高版本)
  • iPhone
简单的范例：
完整的范例：
geolocation.watchPosition
监视设备的当前位置的变化。
参数：
  • geolocationSuccess： 获取位置信息成功时调用的回调函数，参数为当前位置信息。
  • geolocationError：（可选项）获取位置信息出错时调用的回调函数。
  • geolocationOptions：（可选项）地理位置选项。
返回值：
  • String：返回的watch id是位置监视String：返回的watch id是位置监视周期的引用。可以通过geolocation.clearWatch调用该watch ID以停止对位置变化的监视。
说明：
geolocation.watchPosition是一个异步函数。当检测到设备的位置发生改变时，它返回设备的当前位置。当设备检索到一个新的位置，会触发geolocationSuccess回调函数并传递一个Position对象作为参数。如果发生错误，会触发geolocationError回调函数并传递一个PositionError对象。
支持的平台：
  • Android
  • BlackBerry (OS 4.6)
  • BlackBerry WebWorks (OS 5.0或更高版本)
  • iPhone
简单的范例：
完整的范例：
geolocation.clearWatch
停止watchID参数指向的设备位置变化监视。
参数：
  • watchID：要清除的watchPosition周期的id。（字符串类型）
说明：
geolocation.clearWatch函数通过清除watchID指向的geolocation.watchPosition来停止对设备位置变化的监视。
支持的平台：
  • Android
  • BlackBerry (OS 4.6)
  • BlackBerry WebWorks (OS 5.0或更高版本)
  • iPhone
简单的范例：
完整的范例：
geolocationSuccess
当得到一个有效地理位置信息时，此用户回调函数被调当获得一个地理位置信息时，此用户回调函数被调用。
参数：
  • position：设备返回的地理位置信息。（Position类型）
范例：
geolocationError
当geolocation函数发生错误时，此用户回调函数被调用。
参数：
  • error：设备返回的错误信息。（PositionError类型）
geolocationOptions
用户定制地理位置检索的可选参数。
选项：
  • frequency：以毫秒为单位的检索位置周期。这个选项并非W3C规范的一部分，未来会被删除并用maximumAge来替代该选项。（数字类型）（默认值：10000）
  • enableHighAccuracy：提供一个表明应用程序希望获得最佳可能结果的提示。（布尔类型）
  • timeout：允许的以毫秒为单位的最大时间间隔，该时间间隔是从geolocation.getCurrentPosition或geolocation.watchPosition的调用到相应的geolocationSuccess回调函数被调用。（数字类型）
  • maximumAge：应用程序将接受一个缓存的位置信息，当该缓存的位置信息的年龄不大于此参数设定值，单位是毫秒。（数字类型）
Android的特异情况：
除非enableHighAccuracy选项被设定为true，否则Android 2.X模拟器不会返回一个地理位置结果。
Position
包含由geolocation API创建的Position坐标信息。
属性：
  • coords：一系列地理坐标。（Coordinates类型）
  • timestamp：以毫秒为单位的coords的创建时间戳。（DOMTimeStamp类型）
说明：
Position对象是由PhoneGap创建和填充的，并通过一个回调函数返回用户。
支持的平台：
  • Android
  • BlackBerry (OS 4.6)
  • BlackBerry WebWorks (OS 5.0或更高版本)
  • iPhone
简单的范例：
完整的范例：
iPhone的特异情况：
  • timestamp：单位为秒而非毫秒。
一种变通方法是手动将时间戳转换为毫秒（*1000）：
PositionError
当发生错误时，一个PositionError对象会传递给geolocationError回调函数。
属性：
  • code：一个在下面常量列表中定义的错误代码。
  • message：说明错误细节的错误信息。
常量：
  • PositionError.PERMISSIONPositionError.PERMISSION_DENIED：权限被拒绝
  • PositionError.POSITION_UNAVAILABLE：位置不可用
  • PositionError.TIMEOUT：超时
说明：
当使用Geolocation发生错误时，一个PositionError对象会作为geolocationError回调函数的参数传递给用户。
Coordinates
一系列用来描述位置的地理坐标信息的属性。
属性：
  • latitude：以十进制表示的纬度。（数字类型）
  • longitude：以十进制表示的经度。（数字类型）
  • altitude：位置相对于椭圆球面的高度，单位为米。（数字类型）
  • accuracy：以米为单位的纬度和经度坐标的精度水平。（数字类型）
  • altitudeAccuracy：以米为单位的高度坐标的精度水平。（数字类型）
  • heading：运动的方向，通过相对正北做顺时针旋转的角度指定。（数字类型）
  • speed：以米/秒为单位的设备当前地面速度。（数字类型）
说明：
作为Position对象的一部分，Coordinates对象是由PhoneGap创建和填充的。该Position对象会作为一个回调函数的参数返回用户。
支持的平台：
  • Android
  • BlackBerry (OS 4.6)
  • BlackBerry WebWorks (OS 5.0或更高版本)
  • iPhone
简单的范例：
完整的范例：
Android的特异情况：
altitudeAccuracy： Android设备上不支持该属性，返回值总是null。
分享到：
| PhoneGap API帮助文档翻译—Events（事件） ...
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

    PhoneGap,API帮助文档.zip

    9. **定位（Geolocation）**：定位API利用GPS、Wi-Fi或蜂窝网络来获取设备的地理位置信息，这对于地图应用和基于位置的服务至关重要。 10. **媒体（Media）**：媒体API支持音频播放、录音和回放功能，使得开发者...

    PhoneGap,API帮助文档翻译整理9-Geolocation_(定位)

    `geolocation.getCurrentPosition` 是 Geolocation API 的关键方法，用于获取设备的当前位置。这个方法是异步的，意味着它不会立即返回结果，而是通过传递给 `geolocationSuccess` 回调函数的 `Position` 对象来传递...

    PhoneGap的API组件及使用方法

    4. **地理定位** (Geolocation): `navigator.geolocation`接口提供了获取设备当前位置的能力，支持GPS、Wi-Fi和移动网络定位。 5. **通知** (Notification): 提供了弹出框、振动和声音提示等功能，增强用户交互体验...

    phonegap api中文手册

    本手册为PhoneGap API的中文版指南，旨在为开发者提供全面、详细的API使用指导，帮助其利用PhoneGap框架开发跨平台移动应用。PhoneGap是一款基于HTML、CSS和JavaScript的技术栈，允许开发者构建适用于多个移动操作...

    PhoneGap API之事件处理.

    5. **地理定位事件**：通过`Geolocation`接口，开发者可以监听位置更新事件。例如，`watchPosition`方法会周期性地返回当前位置，并在位置改变时触发`position`事件。 6. **媒体事件**：使用`Media`对象处理音频...

    Phonegap API中文版

    例如，`Camera` API用于拍照或从相册选择图片，`Geolocation` API获取设备位置信息，`Accelerometer` API监测设备的运动状态。 4. **插件系统**：PhoneGap的核心API可能无法满足所有需求，但其强大的插件系统允许...

    Phonegap_API_中文版

    3. **位置服务**：PhoneGap的Geolocation API让你能够获取设备的地理位置信息，包括经度、纬度、高度、速度等。通过监听`watchPosition`或调用`getCurrentPosition`，你可以实时追踪或获取一次性的位置数据。 4. **...

    Phonegap API Demo(New)

    7. **地理定位API**：获取设备的地理位置信息，如经纬度、高度、速度等。`navigator.geolocation`对象提供了`watchPosition`和`getCurrentPosition`方法。 8. **文件系统API**：提供访问本地文件系统的能力，可以...

    Phonegap API Demo

    PhoneGap API Demo是一个集合了PhoneGap API实际应用的示例项目，旨在帮助开发者更好地理解和使用PhoneGap技术。PhoneGap是一个开源框架，它允许开发者使用HTML、CSS和JavaScript来构建跨平台的移动应用，同时能够...

    html5框架PhoneGap API详解笔记(ppt及word版)

    4. **地理定位API（Geolocation API）**：获取设备的经纬度、速度、方向等位置信息。 5. **相机API（Camera API）**：拍照或从图库选择图片，并进行裁剪。 6. **文件系统API（File System API）**：读写文件和目录，...

    PhoneGap - API 中文说明

    PhoneGap - API 中文说明 Accelerometer 加速度计 Camera 相机 Capture 捕捉 Compass 指南针 Contacts 联系人 Device 设备 ...Geolocation 地理位置 Media 媒体 Network 网络 Notification 通知 Storage 存储

    PhoneGap中文API

    4. **PhoneGap API**: 这个API包括了多个模块，如`Accelerometer`（加速度计）、`Geolocation`（定位服务）、`Notification`（通知）、`Media`（音频播放）等。每个模块都有一系列的函数，如`watchAcceleration`用于...

    PhoneGap - API 中文说明.rar )

    PhoneGap - API 中文说明 Accelerometer 加速度计 Camera 相机 Capture 捕捉 Compass 指南针 Contacts 联系人 Device 设备 ...Geolocation 地理位置 Media 媒体 Network 网络 Notification 通知 Storage 存储

    phonegap-geolocation:地理位置

    PhoneGap Geolocation是基于JavaScript的移动开发框架PhoneGap中的一个重要特性，它允许开发者获取设备的地理位置信息，如经度、纬度、海拔、速度、方向等。PhoneGap是Adobe的一个开源项目，它允许使用HTML、CSS和...

    【DOC】PhoneGap_API

    10. Geolocation：地理定位API用于获取设备的经纬度位置。尽管在某些平台上标记为不支持，但这通常是由于隐私设置或权限问题，开发者需要确保正确请求用户授权。 11. Media：媒体API用于播放、录制和控制音频文件。...

    PhoneGap实例

    `geolocation` API可以获取设备的位置信息。这些功能在`phonegap100_apidemo`中通常会有专门的示例代码来演示如何调用和使用。 3. **文件系统访问**：通过`file` API，开发者可以读写本地文件，创建文件夹结构，这...

    phoneGAP2.9.1.zip

    - **地理定位**：集成Geolocation API，获取用户的实时位置信息。 - **加速计**：访问设备的加速度数据，用于游戏或其他需要检测设备运动的应用。 - **网络连接检查**：检测设备的网络状态，如WiFi、蜂窝数据等。...

    PhoneGap简单示例

    4. PhoneGap API：这是PhoneGap的核心部分，包括了如设备信息、文件系统、网络状态、通知、相机、媒体、地理定位等接口。通过这些API，JavaScript可以与设备的底层功能进行交互。 5. 构建环境：PhoneGap Desktop ...

    Geolocation:应用地理定位phonegap javascript

    在JavaScript和PhoneGap框架下，开发者可以利用Geolocation API获取设备的地理位置信息，从而实现各种基于位置的服务。PhoneGap是一个允许开发者使用HTML、CSS和JavaScript来构建原生移动应用的框架，它将Web技术与...

Magicbox
Global site tag (gtag.js) - Google Analytics