GeocodeResult

地理编码结果包含有关某个地点的地理位置信息。

JSON 表示法 
{
  "place": string,
  "placeId": string,
  "location": {
    object (LatLng)
  },
  "granularity": enum (GeocodeResult.Granularity),
  "viewport": {
    object (Viewport)
  },
  "bounds": {
    object (Viewport)
  },
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (GeocodeResult.AddressComponent)
    }
  ],
  "postalCodeLocalities": [
    {
      object (LocalizedText)
    }
  ],
  "types": [
    string
  ],
  "plusCode": {
    object (PlusCode)
  }
}
字段
place

string

对于 v4alpha/v4beta 用户，请务必采取行动： 此字段即将从旧格式“//places.googleapis.com/places/{placeID}”更新为新格式“places/{placeId}”。请确保您的应用在过渡期间可以处理这两种格式。旧格式预计将于 2026 年 5 月底之前完全弃用。

此结果的完全限定地点标识符。格式为“//places.googleapis.com/places/{placeID}”。如需了解详情，请参阅 https://developers.google.com/maps/documentation/places/web-service/place-id。
placeId

string

地点的唯一标识符。
location

object (LatLng)

此地址的纬度和经度。
granularity

enum (GeocodeResult.Granularity)

位置的粒度。
viewport

object (Viewport)

适合显示地理编码结果的视口。
bounds

object (Viewport)

地址的边界框。
formattedAddress

string

单行格式的地址。
postalAddress

object (PostalAddress)

邮政地址格式的地址。
addressComponents[]

object (GeocodeResult.AddressComponent)

每个区域级别重复的组成部分。
postalCodeLocalities[]

object (LocalizedText)

邮政编码中包含的区域的完整列表。

仅当结果的类型为“postal_code”时，此字段才会填充。
types[]

string

此结果的一组类型标记。例如，“political”和“administrative_area”。

如需查看可能值的完整列表，请参阅 https://developers.google.com/maps/documentation/places/web-service/place-types 中的表 A 和表 B。
plusCode

object (PlusCode)

此地理编码中位置的 Plus Code。

GeocodeResult.AddressComponent

构成格式化地址的结构化组成部分（如果此信息可用）。

JSON 表示法 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
字段
longText

string

地址组成部分的完整文本说明或名称。例如，澳大利亚国家/地区的地址组成部分可能包含长名称“Australia”。
shortText

string

地址组成部分的缩写文本名称（如果有）。例如，澳大利亚国家/地区的地址组成部分可能包含短名称“AU”。
types[]

string

一个数组，表示地址组成部分的类型。

如需了解详情，请参阅 https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types。
languageCode

string

用于格式化此组件的语言，采用 CLDR 表示法。