通知：Google Maps Platform 即将推出全新基本地图样式。此次地图样式更新包括全新默认调色板、经过现代化改进的图钉，以及地图体验和易用性方面的改进。所有地图样式将于 2025 年 3 月自动更新。如需详细了解适用范围以及如何提前选择启用，请参阅全新 Google Maps Platform 地图样式。

此页面由 Cloud Translation API 翻译。

Geocoder

Geocoder 类

google.maps.Geocoder 类

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

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

构造函数
`Geocoder`	`Geocoder()` 参数：无创建 `Geocoder` 的新实例，用于向 Google 服务器发送地理编码请求。

方法
`geocode`	`geocode(request[, callback])` 参数： `request`：`GeocoderRequest` `callback`：`function(Array<GeocoderResult> optional, GeocoderStatus): void optional` 返回值： `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`。系统仅返回符合所有过滤条件的结果。在所支持的拼写更正和部分匹配方法方面，过滤值与其他地理编码请求相同。可选。
`language optional`	类型： `string optional` 应返回结果的语言的语言标识符（如果可能）。请参阅支持的语言列表。
`location optional`	类型： `LatLng\|LatLngLiteral optional` 要搜索的 `LatLng`（或 `LatLngLiteral`）。地理编码器会执行反向地理编码。如需了解详情，请参阅反向地理编码。必须提供 `address`、`location` 和 `placeId` 中的一个，且只能提供一个。
`placeId optional`	类型： `string optional` 与营业地点相关联的地点 ID。地点 ID 可唯一标识 Google Places 数据库中和 Google 地图上的地点。如需详细了解地点 ID，请参阅 Places API 开发者指南。地理编码器会执行反向地理编码。如需了解详情，请参阅反向地理编码。必须提供 `address`、`location` 和 `placeId` 中的一个，且只能提供一个。
`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` 与 `locality` 和 `sublocality` 类型匹配。可选。
`postalCode optional`	类型： `string optional` 与 `postal_code` 和 `postal_code_prefix` 匹配。可选。
`route optional`	类型： `string optional` 用于匹配 `route` 的全称或简称。可选。

GeocoderStatus 常量

google.maps.GeocoderStatus 常量

Geocoder 在调用 geocode() 完成后返回的状态。您可以按值指定这些参数，也可以使用常量的名称指定这些参数。例如 '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 接口

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

属性
`results`	类型： `Array<GeocoderResult>` `GeocoderResult` 的列表。

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>` 一个字符串数组，这些字符串表示传回的地址解析元素的类型。如需查看可能的字符串列表，请参阅《开发者指南》的地址组成部分类型部分。
`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`	类型： `GeocoderLocationType` `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`	传回的结果反映了精确的地址解析。