Method: geocode.address.geocodeAddress

此方法会执行地址地理编码,将地址映射到 LatLng。它还提供有关地址的结构化信息。

HTTP 请求

GET https://geocode.googleapis.com/v4alpha/geocode/address

网址采用 gRPC 转码语法。

查询参数

参数
locationBias

object (GeocodeAddressRequest.LocationBias)

可选。要搜索的区域。此位置用作偏向,这意味着系统会优先显示给定位置周围的结果。

languageCode

string

可选。返回结果时应使用的语言。

regionCode

string

可选。地区代码。地区代码,以 ccTLD(“顶级域名”)双字符值的形式指定。该参数会根据适用法律影响结果。此参数也会影响但不会完全限制服务中的结果。

effort

enum (GeocodeAddressRequest.Effort)

可选。客户端请求的工作量级别。

要进行地理编码的地址。以下是互斥字段列表。在响应中,最多只能设置其中一个字段:
addressQuery

string

要进行地理编码的非结构化地址。

address

object (PostalAddress)

要进行地理编码的结构化地址,采用邮政地址格式。

互斥字段结束。

请求正文

请求正文必须为空。

响应正文

如果成功,则响应正文包含一个 GeocodeAddressResponse 实例。

授权范围

需要以下 OAuth 范围之一:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address