Geocoder

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

Geocoder

google.maps.Geocoder

用于在地址和 LatLng 之间进行转换的服务。

Geocoder
Geocoder()
参数:无
用于创建 Geocoder 的新实例,可向 Google 服务器发送地理编码请求。
geocode
geocode(request[, callback])
参数
对请求内容进行地址解析。

GeocoderRequest 接口

google.maps.GeocoderRequest接口

要发送到 Geocoder 的地理编码请求的规范。

address optional
类型string optional
要进行地理编码的地址。必须提供且只能提供 addresslocationplaceId 中的一个。
bounds optional
要搜索的 LatLngBounds。选填。
componentRestrictions optional
组件用于将结果限制在特定区域。过滤条件由以下一个或多个部分组成:routelocalityadministrativeAreapostalCodecountry。系统仅返回符合所有过滤条件的结果。在所支持的拼写更正和部分匹配方法方面,过滤值与其他地理编码请求相同。选填。
Betalanguage optional
类型string optional
返回结果时所用语言的语言标识符(如果可以的话)。请参阅支持的语言列表
location optional
类型LatLng|LatLngLiteral optional
要搜索的 LatLng(或 LatLngLiteral)。地理编码器执行反向地理编码。如需了解详情,请参阅反向地理编码。必须提供且只能提供 addresslocationplaceId 中的一个。
placeId optional
类型string optional
与营业地点相关联的地点 ID。地点 ID 是 Google Places 数据库和 Google 地图上的唯一标识符。如需详细了解地点 ID,请参阅 Places API 开发者指南。地理编码器执行反向地理编码。如需了解详情,请参阅反向地理编码。必须提供且只能提供 addresslocationplaceId 中的一个。
region optional
类型string optional
用于使搜索偏向的国家/地区代码,指定为两个字符(非数字)Unicode 区域子标记/ CLDR 标识符。(可选)如需了解受支持的区域,请参阅 Google Maps Platform 覆盖范围详情

GeocoderComponentRestrictions 接口

google.maps.GeocoderComponentRestrictions接口

GeocoderComponentRestrictions 表示解析为特定区域的一组过滤条件。如需详细了解相关工作原理,请参阅地理编码组件过滤

administrativeArea optional
类型string optional
匹配所有 administrative_area levels。选填。
country optional
类型string optional
匹配国家/地区名称或两个字母的 ISO 3166-1 国家/地区代码。选填。
locality optional
类型string optional
同时匹配 localitysublocality 类型。选填。
postalCode optional
类型string optional
匹配 postal_codepostal_code_prefix。选填。
route optional
类型string optional
匹配 route 的长名称或短名称。选填。

GeocoderStatus 常量

google.maps.GeocoderStatus 常量

Geocoder 在完成对 geocode() 的调用后返回的状态。可以通过指定值或使用常量名称来指定变量。例如 'OK'google.maps.GeocoderStatus.OK

ERROR 连接 Google 服务器时遇到了问题。
INVALID_REQUEST GeocoderRequest无效。
OK 响应包含有效的 GeocoderResponse
OVER_QUERY_LIMIT 网页发出请求的频率过高,超过了最短时间限制。
REQUEST_DENIED 不允许网页使用地址解析器。
UNKNOWN_ERROR 由于服务器错误而无法处理地址解析请求。如果您重试一次,请求可能会成功
ZERO_RESULTS 未找到与此“GeocoderRequest”相符的结果。

GeocoderResponse 接口

google.maps.GeocoderResponse接口

包含 GeocoderResult 列表的 Geocoder 返回的地理编码器响应。

results
GeocoderResult 列表。

GeocoderResult 接口

google.maps.GeocoderResult接口

从地址解析服务器检索获得的单个地址解析器结果。一个地址解析请求可能会返回多个结果对象。请注意,尽管该结果为“类 JSON”,但它并非严格意义上的 JSON,因为该结果间接包含了 LatLng 对象。

address_components
GeocoderAddressComponent 的数组
formatted_address
类型string
包含此营业地点的可人工读取地址的字符串。
geometry
一个 GeocoderGeometry 对象
place_id
类型string
与营业地点相关联的地点 ID。地点 ID 是 Google Places 数据库和 Google 地图上的唯一标识符。如需详细了解地点 ID,请参阅 Places API 开发者指南。
types
类型Array<string>
一个字符串数组,这些字符串表示传回的地址解析元素的类型。如需查看可能的字符串列表,请参阅开发者指南的地址组成部分类型部分。
partial_match optional
类型boolean optional
尽管地理编码器能够匹配所请求的地址的一部分,但并不能针对原始请求返回完全匹配。如果完全匹配,则值为 undefined
plus_code optional
类型PlacePlusCode optional
与营业地点相关联的 Plus Code。
postcode_localities optional
类型Array<string> optional
一个字符串数组,表示邮政编码中包含的所有市行政区。只有当结果是一个包含多个地方的邮政编码时,才会有此数组。

GeocoderAddressComponent 接口

google.maps.GeocoderAddressComponent接口

GeocoderResult 中的单个地址组成部分。一个完整地址可能由多个地址组件组成。

long_name
类型string
地址组件的完整文本
short_name
类型string
指定地址组件的简短缩写文本
types
类型Array<string>
一个字符串数组,表示此地址组成部分的类型。有效类型的列表可在此处找到

GeocoderGeometry 接口

google.maps.GeocoderGeometry接口

关于此GeocoderResult的几何图形信息

location
类型LatLng
此结果的纬度/经度坐标
location_type
location 中返回的位置类型
viewport
类型LatLngBounds
用于显示此 GeocoderResult 的推荐视口的边界
bounds optional
类型LatLngBounds optional
GeocoderResult 的精确边界(如果适用)

GeocoderLocationType 常量

google.maps.GeocoderLocationType 常量

用于描述从地理编码所返回的位置类型。可以通过指定值或使用常量名称来指定变量。例如,'ROOFTOP'google.maps.GeocoderLocationType.ROOFTOP

APPROXIMATE 传回的结果是近似值。
GEOMETRIC_CENTER 传回的结果是线(例如街道)或多边形(区域)等结果的几何中心。
RANGE_INTERPOLATED 返回的结果反映了两个精确点(例如交叉路口)之间用内插法计算得到的近似值(通常在道路上)。当某个街道地址的 rooftop 地理编码不可用时,通常会返回内插值结果。
ROOFTOP 传回的结果反映了精确的地址解析。