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 常量

完成对 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`	类型：`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 代码。
`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`	传回的结果反映了精确的地址解析。