该对象封装了指定地理位置的多种方式。当从属于 Device 对象时，它表示设备的位置，也可理解为用户的当前位置；当从属于 User 对象时，它表示用户常驻地（home base，即不一定是其当前位置）。lat/lon 属性只有在其精度符合 type 属性所刻画的精度时才应传递；例如，邮编等地理区域的质心不应被传递。译稿校对中ENThis object encapsulates various methods for specifying a geographic location. When subordinate to a Device object, it indicates the location of the device which can also be interpreted as the user's current location. When subordinate to a User object, it indicates the location of the user's home base (i.e., not necessarily their current location). The lat/lon attributes should only be passed if they conform to the accuracy depicted in the type attribute. For example, the centroid of a geographic region such as postal code should not be passed.
| Attribute | Type | Description |
|---|---|---|
| lat | float | 纬度，取值范围 -90.0 至 +90.0，负值表示南纬。译稿校对中ENLatitude from -90.0 to +90.0, where negative is south. |
| lon | float | 经度，取值范围 -180.0 至 +180.0，负值表示西经。译稿校对中ENLongitude from -180.0 to +180.0, where negative is west. |
| type | integer | 位置数据来源；在传递 lat/lon 时建议一并传递。参见列表 5.20（List 5.20）。译稿校对中ENSource of location data; recommended when passing lat/lon. Refer to List 5.20.枚举 Location Types · 3 个值1GPS/Location Services 2IP Address 3User Provided (e.g., registration data) |
| accuracy | integer | 估计的定位精度，单位为米；当 lat/lon 已指定且源自设备定位服务（即 type = 1）时建议传递。注意：此为设备上报的精度，确切含义请参阅对应操作系统的文档（如 Android、iOS）。译稿校对中ENEstimated location accuracy in meters; recommended when lat/lon are specified and derived from a device's location services (i.e., type = 1). Note that this is the accuracy as reported from the device. Consult OS specific documentation (e.g., Android, iOS) for exact interpretation. |
| lastfix | integer | 自本次定位确立（geolocation fix）以来经过的秒数。注意：设备可能跨多次读取缓存位置数据；理想情况下，该取值应自实际定位时刻起算。译稿校对中ENNumber of seconds since this geolocation fix was established. Note that devices may cache location data across multiple fetches. Ideally, this value should be from the time the actual fix was taken. |
| ipservice | integer | 如适用（即 type = 2），用于根据 IP 地址判定地理位置的服务或提供方。参见列表 5.23（List 5.23）。译稿校对中ENService or provider used to determine geolocation from IP address if applicable (i.e., type = 2). Refer to List 5.23.枚举 IP Location Services · 6 个值1ip2location 2Neustar (Quova) 3MaxMind 4NetAcuity (Digital Element) 51151Degrees (High Confidence) 51251Degrees (Medium Confidence) |
| country | string | 国家代码，采用 ISO-3166-1-alpha-3 编码。译稿校对中ENCountry code using ISO-3166-1-alpha-3. |
| region | string | 地区代码，采用 ISO-3166-2 编码；如为美国，则使用两位字母的州代码。译稿校对中ENRegion code using ISO-3166-2; 2-letter state code if USA. |
| regionfips104 | string | 国家下属地区，采用 FIPS 10-4 表示法。OpenRTB 虽仍支持该属性，但 FIPS 10-4 标准已于 2008 年被 NIST 废止。译稿校对中ENRegion of a country using FIPS 10-4 notation. While OpenRTB supports this attribute, it has been withdrawn by NIST in 2008. |
| metro | string | Google 都市圈代码（metro code）；与尼尔森 DMA 类似但不完全相同。代码表链接参见附录 A。译稿校对中ENGoogle metro code; similar to but not exactly Nielsen DMAs. See Appendix A for a link to the codes. |
| city | string | 城市，采用联合国贸易与运输地点代码（United Nations Code for Trade & Transport Locations）。代码表链接参见附录 A。译稿校对中ENCity using United Nations Code for Trade & Transport Locations. See Appendix A for a link to the codes. |
| zip | string | 邮政编码（zip 或 postal code）。译稿校对中ENZip or postal code. |
| utcoffset | integer | 当地时间相对 UTC 的偏移量，以分钟数正负值（+/-）表示。译稿校对中ENLocal time as the number +/- of minutes from UTC. |
| ext | object | 供交易平台（exchange）对 OpenRTB 进行专属扩展（exchange-specific extensions）的占位对象。译稿校对中ENPlaceholder for exchange-specific extensions to OpenRTB. |
译注
译者注Geo：Device 与 User 的子对象，同一结构因挂载位置不同而语义有别：挂在 Device 下表示设备位置（可近似理解为用户当前位置）；挂在 User 下表示用户常驻地（home base，不一定是当前位置）。业内文档一般保留英文对象名 Geo。译稿校对中
lat/lon 与 type 的一致性：经纬度只有在其精度符合 type 所声明的来源时才应传递；地理区域的质心（如邮编区质心）并非设备或 IP 级定位结果，不得冒充传递——这是合规与反作弊审计中的常见核查点。译稿校对中
lastfix：fix 指一次定位确立。设备可能在多次读取间缓存位置数据，因此 lastfix 理想情况下应自实际定位时刻起算，而非缓存读取时刻；竞价方可据此评估位置数据的新鲜度。译稿校对中
regionfips104：FIPS 10-4 已被 NIST 于 2008 年废止，此字段仅为向后兼容保留；新接入方建议使用 region（ISO-3166-2）。译稿校对中
metro：Google 的都市圈代码与尼尔森 DMA（Designated Market Area，指定市场区域）类似但不完全一致，跨数据源对账时需注意口径差异；美国境外的流量通常不适用。译稿校对中
utcoffset：以分钟为单位的 UTC 偏移，供投放侧判断当地时间（如分时投放、时区敏感型创意）；它只表达偏移量，不携带夏令时（DST）规则本身。译稿校对中
字段描述已与 2.6 官方 draft 对账；2.5 独有字段来自第三方 Go 实现源（Apache 2.0），官方 PDF 兜底校对 · 初稿校对中