地理编码器类
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 要进行地理编码的地址。必须提供 address 、location 和 placeId 中的一个,且只能提供一个。 |
bounds optional |
类型:
LatLngBounds|LatLngBoundsLiteral optional LatLngBounds 内进行搜索。可选。 |
componentRestrictions optional |
类型:
GeocoderComponentRestrictions optional 组成部分用于将结果限制在特定区域内。过滤条件包含以下一项或多项: route 、locality 、administrativeArea 、postalCode 、country 。系统仅返回符合所有过滤条件的结果。在所支持的拼写更正和部分匹配方法方面,过滤值与其他地理编码请求相同。可选。 |
|
类型:
Array<ExtraGeocodeComputation> optional 可用于完成请求的额外计算的列表。注意:这些额外的计算可能会在响应中返回额外的字段。 |
fulfillOnZeroResults optional |
类型:
boolean optional 兑现响应中 ZERO_RESULT 状态的 promise。这可能是理想情况,因为即使地理编码结果为零,仍可能会返回其他响应级字段。 |
language optional |
类型:
string optional 一种语言标识符,用于指定应尽可能以哪种语言返回结果。请参阅支持的语言列表。 |
location optional |
类型:
LatLng|LatLngLiteral optional 要搜索的 LatLng (或 LatLngLiteral )。地理编码器执行反向地理编码。如需了解详情,请参阅 反向地理编码。必须提供 address 、location 和 placeId 中的一个,且只能提供一个。 |
placeId optional |
类型:
string optional |
region optional |
类型:
string optional 用于对搜索结果进行偏向处理的国家/地区代码,指定为双字符(非数字)Unicode 地区子标记/CLDR 标识符。可选。如需了解支持的地区,请参阅 Google Maps Platform 覆盖范围详细信息。 |
GeocoderComponentRestrictions 接口
google.maps.GeocoderComponentRestrictions
接口
GeocoderComponentRestrictions
表示一组可解析为特定区域的过滤条件。如需详细了解此功能的工作原理,请参阅 地理编码组件过滤。
属性 | |
---|---|
administrativeArea optional |
类型:
string optional 匹配所有 administrative_area levels 。可选。 |
|