Geocoder

Geocoder

google.maps.Geocoder

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

通过调用 const {Geocoder} = await google.maps.importLibrary("geocoding") 进行访问。请参阅 Maps JavaScript API 中的库

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

GeocoderRequest 接口

google.maps.GeocoderRequest 接口

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

address optional
类型string optional
要进行地理编码的地址。必须提供 addresslocationplaceId 这三者并且只能其中之一。
bounds optional
要在其中搜索的 LatLngBounds。可选。
componentRestrictions optional
组件用于将结果限制在特定区域内。过滤条件包含以下一项或多项:routelocalityadministrativeAreapostalCodecountry。系统仅返回符合所有过滤条件的结果。在所支持的拼写更正和部分匹配方法方面,过滤值与其他地理编码请求相同。可选。
language 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 常量

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

通过调用 const {GeocoderStatus} = await google.maps.importLibrary("geocoding") 进行访问。请参阅 Maps JavaScript API 中的库

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 代码。
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

通过调用 const {GeocoderLocationType} = await google.maps.importLibrary("geocoding") 进行访问。请参阅 Maps JavaScript API 中的库

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