Geocoder

地理编码器

google.maps.Geocoder

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

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

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

GeocoderRequest 接口

google.maps.GeocoderRequest 接口

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

address optional
类型:  string optional
要进行地理编码的地址。必须提供 addresslocationplaceId 中的一个,且只能提供一个。
bounds optional
类型:  LatLngBounds|LatLngBoundsLiteral optional
LatLngBounds 内进行搜索。可选。
componentRestrictions optional
类型:  GeocoderComponentRestrictions optional
组成部分用于将结果限制在特定区域内。过滤条件包含以下一项或多项:routelocalityadministrativeAreapostalCodecountry。系统仅返回符合所有过滤条件的结果。在所支持的拼写更正和部分匹配方法方面,过滤值与其他地理编码请求相同。可选。
BetaextraComputations optional
类型:  Array<ExtraGeocodeComputation> optional
可用于完成请求的额外计算的列表。注意:这些额外的计算可能会在响应中返回额外的字段。
fulfillOnZeroResults optional
类型:  boolean optional
兑现响应中 ZERO_RESULT 状态的 promise。这可能是理想情况,因为即使地理编码结果为零,仍可能会返回其他响应级字段。
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。可选。