地理定位技术全解析：从基础到应用实践

### 地理定位技术全解析：从基础到应用实践 #### 1. 地理定位代码基础 在地理定位的实现中，我们常常会用到一些代码来完成地图的创建和标记的添加。以下是一段示例代码： ```javascript var map = new google.maps.Map(document.getElementById("map_canvas"), myOptions); var marker = new google.maps.Marker({ position: positionCoordinates, map: map }); ``` 这段代码的主要作用是创建一个谷歌地图，并在地图上添加一个标记。其中，`map` 是地图对象，`marker` 是标记对象，`positionCoordinates` 表示标记的位置坐标。 #### 2. Position 对象属性 `Position` 对象包含了一些重要的属性，用于表示设备的位置信息。 - **coords 属性**： - `coords` 属性包含了一系列用于定义坐标接口的属性，具体如下表所示： | 属性 | 说明 | | --- | --- | | `coords.latitude` | 地理坐标参考系统为世界大地测量系统（2D）[WGS84]，以十进制度数表示纬度。 | | `coords.longitude` | 地理坐标参考系统为世界大地测量系统（2D）[WGS84]，以十进制度数表示经度。 | | `coords.altitude` | 表示位置的高度，以米为单位，相对于 [WGS84] 椭球体。 | | `coords.accuracy` | 表示纬度和经度坐标的精度水平，以米为单位，属性值必须为非负实数。 | | `coords.altitudeAccuracy` | 以米为单位，属性值必须为非负实数。 | | `coords.heading` | 表示设备的行进方向，以度为单位，范围是 0° ≤ heading < 360°，相对于真北顺时针计数。 | | `coords.speed` | 表示设备当前水平速度分量的大小，以米每秒为单位，属性值必须为非负实数。 | 需要注意的是，只有 `coords.latitude`、`coords.longitude` 和 `coords.accuracy` 这三个属性是保证存在的，其余属性可能会根据设备的能力和所连接的位置信息服务器返回 `null`。`heading` 和 `speed` 属性是根据用户的前一个位置（如果可用）计算得出的。 - **timestamp 属性**： `Position` 对象还拥有 `timestamp` 属性，它表示获取 `Position` 对象的时间，以 `DOMTimeStamp` 形式表示，其工作方式类似于 JavaScript 的 `Date` 对象。 #### 3. 错误处理 当地理定位尝试失败时，`getCurrentPosition()` 的第二个参数（`errorCallback` 函数）会被触发。该回调函数会处理一个 `PositionError` 对象，该对象的 `code` 属性会返回以下错误代码之一： - `PERMISSION_DENIED`（数值为 1）：位置获取过程失败，因为用户没有授予使用地理定位 API 的权限。 - `POSITION_UNAVAILABLE`（数值为 2）：无法确定设备的位置。例如，在位置获取过程中使用的一个或多个位置提供程序报告了内部错误，导致整个过程失败。 - `TIMEOUT`（数值为 3）：在实现成功获取新的 `Position` 对象之前，`timeout` 属性指定的时间已经过去（稍后会解释如何设置超时值）。 以下是处理错误的示例代码： ```javascript function (error) { var typeOfError = error.code; switch (typeOfError) { case(1): alert("Permission denied"); break; case (2): alert("Position unavailable"); break; case (3): alert("Timeout error"); break; } } ``` #### 4. 位置选项 `getCurrentPosition()` 方法还可以接受一个可选的第三个参数，即 `PositionOptions` 类型的对象字面量。这个对象有三个可选属性： - **enableHighAccuracy**： 该属性接受一个布尔值。如果在 `getCurrentPosition()` 或 `watchPosition()` 中省略了 `PositionOptions` 参数，`enableHighAccuracy` 属性的默认值为 `false`；当该属性被省略时，同样使用默认值 `false`。如果将其设置为 `true`，表示应用程序希望获得尽可能准确的位置结果，但这可能会导致响应时间变慢或功耗增加。用户可能会拒绝此功能，或者设备可能无法提供比不设置该标志时更准确的结果。其目的是允许应用程序告知实现，它们不需要高精度的地理定位，从而避免使用消耗大量电量的地理定位提供程序（例如 GPS）。示例代码如下： ```javascript { enableHighAccuracy: true } ``` - **timeout**： 该属性表示从调用 `getCurrentPosition()` 或 `watchPosition()` 到相应的 `successCallback` 函数被调用所允许的最大时间（以毫秒为单位）。如果在给定的超时时间过去之前无法成功获取新的 `Position` 对象，并且在此期间没有发生其他错误，则必须使用一个 `PositionError` 对象调用相应的 `errorCallback`，该对象的错误代码设置为 `TIMEOUT`（数值为 3）。获取用户权限所花费的时间不包括在 `timeout` 属性涵盖的时间段内。`timeout` 属性仅适用于位置获取操作。如果在 `getCurrentPosition()` 或 `watchPosition()` 中省略了 `PositionOptions` 参数，`timeout` 属性的默认值为 `Infinity`；如果提供了负值，则超时值被视为 0；当 `timeout` 属性被省略时，同样使用默认值。 - **maximumAge**： 该属性表示应用程序将接受一个缓存位置，其年龄不超过指定的毫秒数。如果 `maximumAge` 设置为 0，实现必须立即尝试获取新的 `Position` 对象；如果将其设置为 `Infinity`，实现将返回一个缓存位置，而不管其年龄。如果实现没有可用的缓存位置，其年龄小于或等于指定的 `maximumAge`，则必须获取一个新的 `Position` 对象。在 `watchPosition()` 的情况下，`maximumAge` 指的是实现返回的第一个 `Position` 对象。如果在 `getCurrentPosition()` 或 `watchPosition()` 中省略了 `PositionOptions` 参数，`maximumAge` 属性的默认值为 0；如果提供了负值或省略了该属性，同样使用默认值。`maximumAge` 属性对于避免在不需要新鲜位置数据时浪费过多资源获取新位置数据非常有用。示例代码如下： ```javascript navigator.geolocation.getCurrentPosition( successCallback, errorCallback, { maximumAge: 80000 } ); ``` #### 5. watchPosition() 方法 `getCurrentPosition()` 方法允许获取一次性位置，而如果希望应用程序使用持续更新的位置数据，则可以使用 `watchPosition()` 方法。 - **工作原理**： `watchPosition()` 方法最多可以接受三个参数，与 `getCurrentPosition()` 方法相同。调用时，它会立即返回一个长整型值，该值唯一标识一个监视操作，然后异步启动监视操作。该操作首先尝试获取设备的当前位置。如果尝试成功，将使用一个新的 `Position` 对象调用 `successCallback` 函数，表示设备的当前位置；如果尝试失败，将使用一个新的 `PositionError` 对象调用 `errorCallback` 函数，表示相应的错误代码。监视操作将继续监视设备的位置，并在每次位置更改时调用相应的回调函数。监视操作将继续进行，直到使用相应的标识符调用 `clearWatch` 方法为止。需要注意的是，无法设置轮询间隔，这取决于设备本身来确定最佳间隔。 - **示例代码**： ```javascript var positionCoordinates = null; var map = null; var marker = null; function initialize() { navigator.geolocati ```