Package google.maps.geocode.v4beta

索引

• GeocodeService（接口）
• GeocodeAddressRequest（消息）
• GeocodeAddressRequest.LocationBias（消息）
• GeocodeAddressResponse（消息）
• GeocodeLocationRequest（消息）
• GeocodeLocationResponse（消息）
• GeocodePlaceRequest（消息）
• GeocodeResult（消息）
• GeocodeResult.AddressComponent（消息）
• GeocodeResult.Granularity（枚举）
• PlusCode（消息）

GeocodeService

用于执行地理编码的服务。

GeocodeAddress
rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse) 此方法会执行地址地理编码，将地址映射到 LatLng。它还提供与地址相关的结构化信息。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/maps-platform.geocode https://www.googleapis.com/auth/maps-platform.geocode.address

GeocodeLocation
rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse) 此方法会执行地理编码，将 LatLng 映射到地址。它还提供与地址相关的结构化信息。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/maps-platform.geocode https://www.googleapis.com/auth/maps-platform.geocode.location

GeocodePlace
rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult) 此方法使用地点 ID 执行地理编码查询。 授权范围 需要以下 OAuth 范围之一： https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/maps-platform.geocode https://www.googleapis.com/auth/maps-platform.geocode.place

GeocodeAddressRequest

GeocodeService.GeocodeAddress 的请求消息。

字段
location_bias	LocationBias 可选。要搜索的区域。此位置用作偏差，这意味着系统可能会返回给定位置周围的结果。
language_code	string 可选。应返回结果的语言。
region_code	string 可选。区域代码。地区代码，已指定为 ccTLD（“顶级域名”）双字符值。此参数会根据适用法律影响搜索结果。此参数也会影响但不会完全限制该服务中的结果。
联合字段 address_input。要进行地理编码的地址。address_input 只能是下列其中一项：
address_query	string 要进行地理编码的非结构化地址。
address	PostalAddress 要以邮政地址格式进行地理编码的结构化地址。

LocationBias

要搜索的区域。此位置用作偏差，这意味着系统可能会返回给定位置周围的结果。

字段
联合字段 type。位置偏向的类型。type 只能是下列其中一项：
rectangle	Viewport 由东北角和西南角定义的矩形框。rectangle.high() 必须是矩形视口的东北点。rectangle.low() 必须是矩形视口的西南角。rectangle.low().latitude() 不得大于 rectangle.high().latitude()。这会导致经度范围为空。矩形视口的宽度不得超过 180 度。

GeocodeAddressResponse

GeocodeService.GeocodeAddress 的响应消息。

字段
results[]	GeocodeResult 地理编码结果。

GeocodeLocationRequest

GeocodeService.GeocodeLocation 的请求消息。

字段
language_code	string 可选。应返回结果的语言。
region_code	string 可选。区域代码。地区代码，已指定为 ccTLD（“顶级域名”）双字符值。此参数会根据适用法律影响搜索结果。
types[]	string 可选。一组用于限制结果的类型标记。系统会移除不属于任何指定类型的结果。 如需查看可能值的完整列表，请参阅 https://developers.google.com/maps/documentation/places/web-service/place-types 中的表格 A 和表格 B。
granularity[]	Granularity 可选。一个或多个位置精确度枚举的过滤条件。
联合字段 location_input。要进行地理编码的位置。location_input 只能是下列其中一项：
location_query	string 采用“lat,lng”字符串格式的地理位置。例如“64.7611872,-18.4705364”。
location	LatLng 采用结构化格式的营业地点。

GeocodeLocationResponse

GeocodeService.GeocodeLocation 的响应消息。

字段
results[]	GeocodeResult 地理编码结果。
plus_code	PlusCode 请求中相应位置的 Plus Code。

GeocodePlaceRequest

GeocodeService.GeocodePlace 的请求消息。

字段
place	string 必需。要进行地理编码的地点标识符，格式为 places/{place}。
language_code	string 可选。应返回结果的语言。
region_code	string 可选。区域代码。地区代码，已指定为 ccTLD（“顶级域名”）双字符值。此参数会根据适用法律影响搜索结果。

GeocodeResult

地理编码结果包含地点的地理信息。

字段
place	string 此结果的完全限定地点标识符。格式为“//places.googleapis.com/places/{placeID}”。如需了解详情，请访问 https://developers.google.com/maps/documentation/places/web-service/place-id。
place_id	string 此结果的地点 ID。
location	LatLng 此地址的 latlng。
granularity	Granularity 位置的粒度。
viewport	Viewport 适合显示地理编码结果的视口。
bounds	Viewport 地址的边界框。
formatted_address	string 采用单行格式的地址。
postal_address	PostalAddress 地址（采用邮政地址格式）。
address_components[]	AddressComponent 每个地理位置级别的重复组件。
postal_code_localities[]	LocalizedText 邮政编码中包含的市行政区的完整列表。 只有当结果的类型为“postal_code”时，系统才会填充此字段。
types[]	string 此结果的一组类型标记。例如，“political”和“administrative_area”。 如需查看可能值的完整列表，请参阅 https://developers.google.com/maps/documentation/places/web-service/place-types 中的表格 A 和表格 B。
plus_code	PlusCode 此地理编码中相应位置的 Plus Code。

AddressComponent

构成格式化地址的结构化组成部分（如果有）。

字段
long_text	string 地址组成部分的完整文本说明或名称。例如，澳大利亚这个国家/地区的地址组成部分的长名称可能是“澳大利亚”。
short_text	string 地址组成部分的缩写文本名称（如果有）。例如，澳大利亚的国家/地区地址组成部分的短名称可能是“AU”。
types[]	string 一个数组，表示地址组成部分的类型。 如需了解详情，请参阅 https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types。
language_code	string 用于设置此组件格式的语言（采用 CLDR 表示法）。

粒度

位置的粒度。

枚举
GRANULARITY_UNSPECIFIED	请勿使用。
ROOFTOP	与匹配地址对应的实际地块的非插值位置。
RANGE_INTERPOLATED	通过一系列街道编号插值得出。例如，如果我们知道 Amphitheatre Pkwy 的某个路段包含 1600 到 1699 之间的数字，那么 1650 可能会位于其端点的中间位置。
GEOMETRIC_CENTER	具有多边形数据的地图项的几何中心。
APPROXIMATE	所有其他交易。

PlusCode

Plus Code（http://plus.codes）是一种位置参考，有两种格式：全局代码（定义 14 米 x 14 米 [1/8,000 度] 或更小的矩形）和复合代码（将前缀替换为参考位置）。

字段
global_code	string 地点的全局（完整）代码，例如“9FWM33GV+HQ”，表示 1/8, 000 度 x 1/8,000 度（约 14 米 x 14 米）的区域。
compound_code	string 地点的混合代码，例如“33GV+HQ, Ramberg, Norway”，其中包含全局代码的后缀，并将前缀替换为参考实体的格式化名称。