Geocoder

Geocoder 类

google.maps.Geocoder class
library "geocoding"

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

const {Geocoder} = await google.maps.importLibrary("geocoding");

GeocoderRequest 接口

google.maps.GeocoderRequest 接口

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

属性
address 可选	类型：string optional 要进行地理编码的地址。必须提供 address、location 和 placeId 中的一个，且只能提供一个。
bounds 可选	类型：LatLngBounds|LatLngBoundsLiteral optional 要在其中搜索的 LatLngBounds。可选。
componentRestrictions 可选	类型：GeocoderComponentRestrictions optional 组件用于将结果限制在特定区域内。过滤器由以下一项或多项组成：route、locality、administrativeArea、postalCode、country。系统仅返回符合所有过滤条件的结果。在所支持的拼写更正和部分匹配方法方面，过滤值与其他地理编码请求相同。可选。
extraComputations 可选	类型：Array<ExtraGeocodeComputation> optional 可能用于完成请求的额外计算列表。注意：这些额外计算可能会在响应中返回额外字段。
fulfillOnZeroResults 可选	类型：boolean optional 在响应中，如果状态为 ZERO_RESULT，则履行 promise。这可能是您想要的结果，因为即使地理编码结果为零，系统仍可能会返回其他响应级字段。
language 可选	类型：string optional 语言标识符，用于指定应尽可能以哪种语言返回结果。请参阅支持的语言列表。
location 可选	类型：LatLng|LatLngLiteral optional 要搜索的 LatLng（或 LatLngLiteral）。地理编码器执行反向地理编码。如需了解详情，请参阅 反向地理编码。必须提供 address、location 和 placeId 中的一个，且只能提供一个。
placeId 可选	类型：string optional 与营业地点相关联的地点 ID。地点 ID 可唯一标识 Google Places 数据库中和 Google 地图上的地点。如需详细了解地点 ID，请参阅 Places API 开发者指南。地理编码器执行反向地理编码。如需了解详情，请参阅反向地理编码。必须提供 address、location 和 placeId 中的一个，且只能提供一个。
region 可选	类型：string optional 用于偏向搜索的国家/地区代码，指定为双字符（非数字）Unicode 地区子标记/CLDR 标识符。可选。如需了解支持的地区，请参阅 Google Maps Platform 覆盖范围详细信息。

GeocoderComponentRestrictions 接口

google.maps.GeocoderComponentRestrictions 接口

GeocoderComponentRestrictions 表示一组解析为特定区域的过滤条件。如需详细了解其运作方式，请参阅 地理编码组成部分过滤。

ExtraGeocodeComputation 常量

google.maps.ExtraGeocodeComputation 常量
库 "geocoding"

完成地理编码请求时要执行的额外计算。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 ExtraGeocodeComputationString 类型定义。

const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding");

GeocoderStatus 常量

google.maps.GeocoderStatus 常量
库 "geocoding"

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

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 GeocoderStatusString 类型定义。

const {GeocoderStatus} = await google.maps.importLibrary("geocoding");

GeocoderResponse 接口

google.maps.GeocoderResponse 接口

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

属性
results	类型：Array<GeocoderResult> GeocoderResult 的列表。
address_descriptor 可选	类型：AddressDescriptor optional 对位置的关系描述。包含一组按排名顺序排列的附近地标以及包含目标位置的区域。仅针对反向地理编码请求填充，且仅在启用 ExtraGeocodeComputation.ADDRESS_DESCRIPTORS 时填充。
plus_code 可选	类型：PlacePlusCode optional 与营业地点相关联的 Plus Code。

GeocoderResult 接口

google.maps.GeocoderResult 接口

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

属性
address_components	类型：Array<GeocoderAddressComponent> GeocoderAddressComponent 的数组
formatted_address	类型：string 一个字符串，其中包含此位置人类可读的地址。
geometry	类型：GeocoderGeometry 一个 GeocoderGeometry 对象
place_id	类型：string 与营业地点相关联的地点 ID。地点 ID 可唯一标识 Google Places 数据库中和 Google 地图上的地点。如需详细了解地点 ID，请参阅 Places API 开发者指南。
types	类型：Array<string> 一个字符串数组，这些字符串表示传回的地址解析元素的类型。如需查看可能字符串的列表，请参阅开发者指南的 地址组成部分类型部分。
address_descriptor 可选	类型：AddressDescriptor optional 与此地理编码关联的位置的关系描述。包含一组经过排名的附近地标以及包含目标位置的区域。此字段仅在以下情况下填充：正向地理编码和地点 ID 查找请求、ExtraGeocodeComputation.ADDRESS_DESCRIPTORS 已启用，以及特定本地化地点。
partial_match 可选	类型：boolean optional 地理编码器是否无法返回与原始请求完全匹配的结果，尽管它能够匹配所请求地址的一部分内容。如果完全匹配，则值为 undefined。
plus_code 可选	类型：PlacePlusCode optional 与营业地点相关联的 Plus Code。
postcode_localities 可选	类型：Array<string> optional 一个字符串数组，用于表示邮政编码中包含的所有市行政区。只有当结果是一个包含多个地方的邮政编码时，才会有此数组。

AddressDescriptor 接口

google.maps.AddressDescriptor 接口

对位置的关系描述。包含一组按排名排序的附近地标以及包含目标位置的区域。

GeocoderAddressComponent 接口

google.maps.GeocoderAddressComponent 接口

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

GeocoderGeometry 接口

google.maps.GeocoderGeometry 接口

此GeocoderResult的几何信息

GeocoderLocationType 常量

google.maps.GeocoderLocationType 常量
库 "geocoding"

描述从地理编码返回的位置类型。按值或使用常量名称指定这些值。例如，'ROOFTOP' 或 google.maps.GeocoderLocationType.ROOFTOP。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 GeocoderLocationTypeString 类型定义。

const {GeocoderLocationType} = await google.maps.importLibrary("geocoding");

Landmark 接口

google.maps.Landmark 接口

表示地址参考点的地点。

Area 接口

google.maps.Area 接口

包含目标位置的小区域，例如街区、局部行政区或大型建筑群。

包含常量

google.maps.Containment 常量
库 "geocoding"

一个枚举，表示区域与目标位置之间的空间关系。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 ContainmentString 类型定义。

const {Containment} = await google.maps.importLibrary("geocoding");

SpatialRelationship 常量

google.maps.SpatialRelationship 常量
库 "geocoding"

一个枚举，表示地标与目标之间的空间关系。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 SpatialRelationshipString 类型定义。

const {SpatialRelationship} = await google.maps.importLibrary("geocoding");