地址与地理编码

Address Validation API 调用的 response 包含唯一的 address 和唯一的 geocode。address 表示 API 对输入中的地址的最佳理解，geocode 表示 API 对 address 所表示位置的最佳推测。

这种差别有点微妙，因此值得举例说明。

请求

Address Validation API 调用的以下请求正文引用了不存在的街道和门牌号。

{
  "address": {
    "regionCode": "US",
    "administrativeArea": "California",
    "locality": "Mountain View",
    "addressLines": ["123 Fake St"]
  }
}

响应

Address Validation API 调用返回如下所示的响应。响应中有几点需要注意：

• address 包含街道组件“123”和街道组件“Fake St”，两者都标记为 UNCONFIRMED_BUT_PLAUSIBLE。这意味着该 API 无法确认此街道和门牌号是否存在。

  不过，即使我们的数据中不存在此街道和门牌号，API 也能够识别出这部分输入的语义是街道和门牌号，因此将 inputGranularity 设置为 PREMISE，表示给定的地址可精确到建筑物。

• 请注意，geocodeGranularity 字段为 OTHER，表示返回的地理编码器引用了一个较大的区域。事实上，在 placeTypes 字段中，您可以看到地理编码的类型为 locality，这是因为 API 无法找到街道编号或街道。

{
  "result": {
    "verdict": {
      "inputGranularity": "PREMISE",
      "validationGranularity": "OTHER",
      "geocodeGranularity": "OTHER",
      "hasUnconfirmedComponents": true
    },
    "address": {
      "formattedAddress": "123 Fake St, Mountain View, CA, USA",
      "postalAddress": {
        "regionCode": "US",
        "languageCode": "en",
        "administrativeArea": "CA",
        "locality": "Mountain View",
        "addressLines": [
          "123 Fake St"
        ]
      },
      "addressComponents": [
        {
          "componentName": {
            "text": "123",
            "languageCode": "en"
          },
          "componentType": "street_number",
          "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
        },
        {
          "componentName": {
            "text": "Fake St",
            "languageCode": "en"
          },
          "componentType": "route",
          "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
        },
        {
          "componentName": {
            "text": "Mountain View",
            "languageCode": "en"
          },
          "componentType": "locality",
          "confirmationLevel": "CONFIRMED"
        },
        {
          "componentName": {
            "text": "CA",
            "languageCode": "en"
          },
          "componentType": "administrative_area_level_1",
          "confirmationLevel": "CONFIRMED"
        },
        {
          "componentName": {
            "text": "USA",
            "languageCode": "en"
          },
          "componentType": "country",
          "confirmationLevel": "CONFIRMED"
        }
      ],
      "missingComponentTypes": [
        "postal_code"
      ],
      "unconfirmedComponentTypes": [
        "street_number",
        "route"
      ]
    },
    "geocode": {
      "location": {
        "latitude": 37.3860517,
        "longitude": -122.0838511
      },
      "plusCode": {
        "globalCode": "849V9WP8+CF"
      },
      "bounds": {
        "low": {
          "latitude": 37.3567832,
          "longitude": -122.1178619
        },
        "high": {
          "latitude": 37.469887,
          "longitude": -122.0446721
        }
      },
      "featureSizeMeters": 9943.329,
      "placeId": "ChIJiQHsW0m3j4ARm69rRkrUF3w",
      "placeTypes": [
        "locality",
        "political"
      ]
    },
    "uspsData": {
      "standardizedAddress": {
        "firstAddressLine": "123 FAKE ST",
        "cityStateZipAddressLine": "MOUNTAIN VIEW",
        "city": "MOUNTAIN VIEW",
        "state": "CA"
      },
      "dpvFootnote": "A1",
      "dpvCmra": "N",
      "postOfficeCity": "MOUNTAIN VIEW",
      "postOfficeState": "CA"
    }
  },
  "responseId": "20cfe06a-9d39-4da6-80e0-eef852e9ea8d"
}