---
navTitle: $location
---
# $location - 当前地理定位信息

`$location`代表当前位置信息，在表达式中可以通过`$location.xxx`的形式获取位置的详细信息，如：

- `$location.country` - 当前位置所在国家，如：中国
- `$location.province` - 当前位置所在省份，如：湖北省
- `$location.city` - 当前位置所在城市，如：武汉市
- `$location.cityCode` - 当前位置所在的城市编码，如：027
- `$location.district` - 当前位置所在区/县：如：江汉区
- `$location.streetInfo` - 当前位置所在街道信息，如：发展大道207号
- `$location.postCode` - 当前位置的邮政编码，如：430022
- `$location.adCode` - 当前位置的区域代码，如：420010
- `$location.address` - 当前位置的详细地址信息，如：湖北省武汉市江汉区发展大道207号
- `$location.lng` - 当前位置的经度，如：114.34686
- `$location.lat` - 当前位置的纬度，如：30.58448

## **GPS定位**{#locate}

- **GPS**：全球定位系统（英文：Global Positioning System），是一种以人造地球卫星为基础的高精度无线电导航的定位系统，它在全球任何地方以及近地空间都能够提供准确的地理位置、车行速度及精确的时间信息。
- **室内GPS**：GPS是接收卫星直射下来的信号，室内的建筑物会遮挡卫星发射的信号，导致室内定位的精度会受到影响。
- **移动端GPS**：移动端包括手机、PAD和其它带有GPS定位芯片的智能设备（如手表、音箱等），成功定位需要满足以下四个条件：
  - 移动端GPS打开，且所使用的App或浏览器已获取定位权限。
  - iOS10以上系统和Android的一些版本，已禁止在非`HTTPS`协议的域名下定位，需要升级到`HTTPS`。
  - 微信7.0版本升级了对`HTTPS`的安全限制，导致`HTTPS`的定位不能正常使用，导致出现苹果可以正常获取定位，安卓获取不到的现象，若出现该问题需要将站点升级到`HTTPS`。
  - 在连接WIFI的情况下，移动端获取的是WIFI定位结果，在GPS定位受限时，可以通过WIFI网络获取定位信息。
- **PC端GPS**：PC设备上一般缺少GPS芯片，主要通过IP进行定位，定位精度相对移动GPS较低。

## 坐标介绍{#axis}

1. `WGS84`：国际坐标系，为一种大地坐标系，也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
2. `GCJ02`：火星坐标系，是由中国国家测绘局制订的地理信息系统的坐标系统。 由WGS84坐标系经加密后的坐标系。
3. `BD09`：百度坐标系，在GCJ02坐标系基础上再次加密。

目前产品通过HTML5的`Geolocation API`接口获取地理定位，返回是GPS坐标，即WGS84坐标。如果在页面中使用了`$location.lng`、`$location.lat`表达式，会在用户客户端通过GPS查询当前位置经纬度，并通过`Geolocation API`接口将该经纬度返回。