Адрес против геокода

response на вызов API проверки адреса содержит уникальный address и уникальный geocode . address представляет собой лучшее понимание API адреса во входных данных, а geocode представляет собой лучшее предположение API о местоположении, представленном address .

Эта разница довольно тонкая, поэтому ее стоит проиллюстрировать на примере.

Запрос

Следующий текст запроса к вызову API проверки адреса относится к улице и номеру улицы, которые не существуют.

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

Ответ

Вызов 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"
}