View a markdown version of this page

アドレスの検証 - Amazon Location Service
アドレス検証機能検証のユースケースに対処する入力スキーマ出力スキーマ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

アドレスの検証

アドレス検証ジョブは、アドレスデータを処理してアドレスを検証し、標準化します。このサービスは、自由形式のアドレス行と構造化されたアドレスコンポーネントの両方をサポートし、オプションで地理的座標と国固有の郵便番号属性を使用して結果を強化できます。

住所の検証では、オーストラリア、カナダ、英国、米国の住所がサポートされています。

アドレス検証機能

アドレス検証には、アドレスデータを検証および強化するための以下の機能があります。

標準化に対処する

アドレス検証では、信頼できるアドレスデータセットと照合することで、アドレスが存在し、配信可能であることを確認します。一貫した略語、大文字、句読点など、公式の郵便番号基準に従って、標準化形式のアドレスに対処します。また、スペルミスなどのエラーを修正し、郵便番号や通りの名前などの住所の欠落コンポーネントを追加します。

検証の強化

アドレス検証ジョブは、検証結果を強化するオプションの追加機能をサポートします。

  • 位置 — 検証されたアドレスの地理的座標 (経度と緯度) を返します。これにより、アドレスをマッピングしたり、地理的分析を実行したりできます。この機能は米国、カナダ、オーストラリアでのみ使用でき、追加料金が発生します。

  • CountrySpecificAttributes — 各国固有の郵便番号システム情報を提供します。たとえば、米国のアドレスは配信ポイントコードやキャリアルート情報などの USPS データを受信し、オーストラリアのアドレスは Australia Post 識別子を受信します。

料金の詳細については、「ジョブの料金」を参照してください。

検証のユースケースに対処する

ヘルスケアシステムと保険者

クレーム処理、ケア調整、および規制報告の要件について、患者とプロバイダーの住所を検証します。

金融サービスと保険業者

顧客の住所を標準化して、ID 検証ワークフロー、リスク評価、不正防止をサポートします。

小売および e コマースオペレーション

顧客データベースをクリーンアップして、配送の失敗を減らし、配送率を向上させ、フルフィルメントコストを最適化します。

輸送および物流プロバイダー

配信アドレスを検証してルートを最適化し、ラストマイルオペレーション全体で失敗した配信を減らします。

データ移行とデータベースメンテナンス

システム移行中に 1 回限りのデータベースクリーンアップを実行し、アドレスレコードを定期的に検証してデータ品質を維持します。

分析、レポート、エンティティ解決

エンティティ解決ワークフローを通じて、ロケーションベースの分析、属性分析、顧客関係管理 (CRM) データベースのクリーンアップのアドレスを標準化します。

入力スキーマ

アドレス検証ジョブには、特定のスキーマの入力データが必要です。スキーマは、自由形式のアドレス行と構造化アドレスコンポーネントの両方をサポートしているため、データに最適な形式でアドレスを送信できます。

入力スキーマには、次のフィールドが含まれます。

ID

この入力レコードに渡すオプションの識別子。指定した場合、出力レコードを対応する入力に関連付けるのに役立つInput_Idように、出力ファイルにミラーリングされます。

アドレス行

自由形式のアドレスAddressLines_5には AddressLines_1～ を使用します。に 1 行入力を入力しますAddressLines_1。複数行の入力は、メールに表示されるため、リージョンの郵便番号に従って順序付けます。

AddressComponents_Country

住所がある国の alpha-2、alpha-3 文字コード、またはフルネーム。

AddressComponents_Region

州、都道府県、地域など、入力アドレスのリージョン。

AddressComponents_SubRegion

郡など、入力アドレスのサブリージョン。

AddressComponents_Locality

都市や町など、入力アドレスのローカル性。

AddressComponents_PostalCode

入力アドレスの郵便番号。

AddressComponents_Street

入力アドレスの通りの名前。

AddressComponents_AddressNumber

入力アドレスの住所または住宅番号。

AddressComponents_Unit

入力アドレスの単位。

AddressComponents_UnitDesignator

Apt、スイート、# など、入力アドレスの単位識別子またはタイプ。

注記

リクエストで AddressLines と AddressComponents の両方を組み合わせる場合は、AddressLines に 1 行目のアドレスコンポーネント (AddressNumber、Street、Unit、UnitDesignator) を入力します。AddressComponents を使用して、最後の行のコンポーネント (Locality、Region、SubRegion、Country、PostalCode) を入力します。

次の Python スクリプトは、アドレスデータを含むサンプル Parquet ファイルを作成します。

import pyarrow as pa
import pyarrow.parquet as pq

data = [
    {
        "Id": "record-001",
        "AddressLines_1": "Pike Place",
        "AddressLines_2": "Apartment 4B",
        "AddressLines_3": None,
        "AddressLines_4": None,
        "AddressLines_5": None,
        "AddressComponents_Country": "USA",
        "AddressComponents_Region": None,
        "AddressComponents_SubRegion": None,
        "AddressComponents_Locality": None,
        "AddressComponents_PostalCode": "98101",
        "AddressComponents_Street": None,
        "AddressComponents_AddressNumber": None,
        "AddressComponents_Unit": None,
        "AddressComponents_UnitDesignator": None
    },
    {
        "Id": "record-002",
        "AddressLines_1": "2901 E Madison St",
        "AddressLines_2": None,
        "AddressLines_3": None,
        "AddressLines_4": None,
        "AddressLines_5": None,
        "AddressComponents_Country": "USA",
        "AddressComponents_Region": None,
        "AddressComponents_SubRegion": None,
        "AddressComponents_Locality": None,
        "AddressComponents_PostalCode": "98112",
        "AddressComponents_Street": None,
        "AddressComponents_AddressNumber": None,
        "AddressComponents_Unit": None,
        "AddressComponents_UnitDesignator": None
    }
]

schema = pa.schema([
    ("Id", pa.string()),
    ("AddressLines_1", pa.string()),
    ("AddressLines_2", pa.string()),
    ("AddressLines_3", pa.string()),
    ("AddressLines_4", pa.string()),
    ("AddressLines_5", pa.string()),
    ("AddressComponents_Country", pa.string()),
    ("AddressComponents_Region", pa.string()),
    ("AddressComponents_SubRegion", pa.string()),
    ("AddressComponents_Locality", pa.string()),
    ("AddressComponents_PostalCode", pa.string()),
    ("AddressComponents_Street", pa.string()),
    ("AddressComponents_AddressNumber", pa.string()),
    ("AddressComponents_Unit", pa.string()),
    ("AddressComponents_UnitDesignator", pa.string())
])

table = pa.Table.from_pylist(data, schema=schema)
pq.write_table(table, 'addresses.parquet')

ファイルサイズの制限については、「」を参照してください入力データを準備する。

出力スキーマ

アドレス検証ジョブは、標準化されたアドレスコンポーネント、検証結果、オプションの追加機能データを含む出力を生成します。以下のセクションでは、アドレス検証固有の出力フィールドについて説明します。

一般的な出力スキーマ情報と結果の取得方法については、「」を参照してくださいジョブ結果の取得。

出力アドレスフィールド

リージョンの郵便番号に従ってフォーマットされた Output_プレフィックスを持つ標準化されたアドレスコンポーネント。

Output_AddressId

返されるアドレスの一意の識別子。

Output_AddressLines_1

返された完全なアドレスの最初の行は、1 通のメールに表示されるため、複数の行に書き込まれます。リージョンの郵便規則に従ってフォーマットされます。

Output_AddressLines_2

返された完全なアドレスの 2 行目は、1 通のメールに表示されるため、複数の行に書き込まれます。リージョンの郵便規則に従ってフォーマットされます。

Output_AddressLines_3

返された完全なアドレスの 3 行目は、1 通のメールに表示されるため、複数の行に書き込まれます。リージョンの郵便規則に従ってフォーマットされます。

Output_AddressLines_4

返された完全なアドレスの 4 行目は、1 通のメールに表示されるため、複数の行に書き込まれます。リージョンの郵便規則に従ってフォーマットされます。

Output_AddressLines_5

返された完全なアドレスの 5 行目は、1 通のメールに表示されるため、複数の行に書き込まれます。リージョンの郵便規則に従ってフォーマットされます。

Output_Address_Label

リージョンの郵便番号ルールに従って、アドレスコンポーネントから構築されたアセンブルされたアドレス。

Output_Address_Country_Code2

国の Alpha-2 文字コード。

Output_Address_Country_Code3

国の Alpha-3 文字コード。

Output_Address_Country_Name

国のフルネーム。

Output_Address_Region_Code

リージョンの省略コード。

Output_Address_Region_Name

リージョンのフルネーム。

Output_Address_SubRegion_Code

サブリージョンの省略コード。

Output_Address_SubRegion_Name

サブリージョンのフルネーム。

Output_Address_Locality

都市や町など、住所のローカル性コンポーネント。

Output_Address_PostalCode

アドレスの完全な郵便番号コンポーネント。

Output_Address_PostalCodeDetails_Base

郵便番号の基本セグメント。

Output_Address_PostalCodeDetails_Extension

郵便番号の拡張またはアドオンセグメント。

Output_Address_Street

アドレスの完全な通りコンポーネント。

Output_Address_StreetComponents_BaseName

通り名のベース名部分。

Output_Address_StreetComponents_Prefix

道路のベース名の前にあるが、含まれていない方向識別子。

Output_Address_StreetComponents_Suffix

道路の基本名に続くが、含まれていない方向識別子。

Output_Address_StreetComponents_Type

、ST、 などAVE、通り名の通りタイプ部分BLVD。

Output_Address_StreetComponents_TypePlacement

通りのタイプがベース名の前か後かを定義します。 (BeforeBaseName または AfterBaseName)

Output_Address_AddressNumber

住所または住所の住宅番号コンポーネント。

Output_Address_SecondaryAddressComponents_Unit_Number

ユニットセカンダリアドレスコンポーネントの英数字識別子。

Output_Address_SecondaryAddressComponents_Unit_Designator

アドレスラベルに表示される単位セカンダリアドレスコンポーネントの識別子。

Output_Address_SecondaryAddressComponents_Floor_Number

フロアセカンダリアドレスコンポーネントの英数字識別子。

Output_Address_SecondaryAddressComponents_Floor_Designator

アドレスラベルに表示されるフロアセカンダリアドレスコンポーネントの識別子。

アドレスメタデータ

アドレスと配信特性に関するメタデータ。

Output_AddressMetadata_DeliveryIndicators_Mailable

住所が郵送可能かどうかを示します。値: true/false

Output_AddressMetadata_DeliveryIndicators_Locatable

アドレスが場所指定可能かどうかを示します。値: true/false

検証結果

アドレスの全体的な検証品質メトリクス。

Output_ValidationResults_ValidationGranularity

返されたアドレスが検証された全体的な粒度のレベルを示します。値:

  • Premise – アドレス番号レベルのすべてのコンポーネントが検証されました

  • Street – 通りレベルへのすべてのコンポーネントが検証されました

  • LocalityAndPostalCode – Locality、PostalCode、および Country が検証されました

  • Locality – 地域と国が検証されました

Output_ValidationResults_MatchConfidence

アドレス検証プロセス中に実行されたアドレス一致の全体的な信頼レベルを示します。値: High、MediumHigh、Medium、MediumLow、Low

Output_ValidationResults_MatchConfidenceScore

一致信頼度の正確なスコアを提供します。0～1.0 の範囲。1.0 は完全一致を示します。

コンポーネント検証ステータス

アドレスコンポーネントごとに、2 つのフィールドが検証結果を示します。

  • Status フィールドは検証ステータスを示します。Validatedまたは Unconfirmed

  • StatusDetail フィールドには、検証ステータスに関する追加の詳細が表示されます。

    • NotFound – コンポーネントが見つからないか、空です。

    • StandardizedNoMatch – コンポーネントは解析および標準化されましたが、参照データでは識別されませんでした。

    • OutOfRange – コンポーネントは特定されませんでした。参照データは、コンポーネントが範囲外であるか不明であることを示しています。

    • Corrected – コンポーネントは参照データを使用して修正されました。

    • Exact – コンポーネントは変更なしで検証されました。

    • Alias – コンポーネントは参照データエイリアスを使用して検証されました。

    • Appended – コンポーネントは参照データを使用して追加されました。

Output_ValidationResults_Components_Address_Country_Status

国コンポーネントの検証ステータス。

Output_ValidationResults_Components_Address_Country_StatusDetail

国コンポーネントの詳細な検証ステータス。

Output_ValidationResults_Components_Address_Region_Status

リージョンコンポーネントの検証ステータス。

Output_ValidationResults_Components_Address_Region_StatusDetail

リージョンコンポーネントの詳細な検証ステータス。

Output_ValidationResults_Components_Address_Locality_Status

ローカリティコンポーネントの検証ステータス。

Output_ValidationResults_Components_Address_Locality_StatusDetail

ローカリティコンポーネントの詳細な検証ステータス。

Output_ValidationResults_Components_Address_Street_Status

道路コンポーネントの検証ステータス。

Output_ValidationResults_Components_Address_Street_StatusDetail

道路コンポーネントの詳細な検証ステータス。

Output_ValidationResults_Components_Address_AddressNumber_Status

アドレス番号コンポーネントの検証ステータス。

Output_ValidationResults_Components_Address_AddressNumber_StatusDetail

アドレス番号コンポーネントの詳細な検証ステータス。

Output_ValidationResults_Components_Address_PostalCodeDetails_Base_Status

郵便番号ベースコンポーネントの検証ステータス。

Output_ValidationResults_Components_Address_PostalCodeDetails_Base_StatusDetail

郵便番号ベースコンポーネントの詳細な検証ステータス。

Output_ValidationResults_Components_Address_PostalCodeDetails_Extension_Status

郵便番号拡張コンポーネントの検証ステータス。

Output_ValidationResults_Components_Address_PostalCodeDetails_Extension_StatusDetail

郵便番号拡張コンポーネントの詳細な検証ステータス。

Output_ValidationResults_Components_Address_SecondaryAddressComponents_Unit_Status

ユニットコンポーネントの検証ステータス。

Output_ValidationResults_Components_Address_SecondaryAddressComponents_Unit_StatusDetail

ユニットコンポーネントの詳細な検証ステータス。

Output_ValidationResults_Components_Address_SecondaryAddressComponents_Floor_Status

フロアコンポーネントの検証ステータス。

Output_ValidationResults_Components_Address_SecondaryAddressComponents_Floor_StatusDetail

フロアコンポーネントの詳細な検証ステータス。

追加機能出力

ジョブの開始時に追加機能をリクエストした場合、出力には以下が含まれます。

ポジション

世界測地系 (WGS 84) 形式の地理座標。

Output_Position_Longitude

世界測地系 (WGS 84) 形式の経度座標。

Output_Position_Latitude

世界測地系 (WGS 84) 形式の緯度座標。

国固有の属性

国固有の郵便番号と国勢調査データ。使用可能なフィールドは国によって異なります。

AustraliaPost
Output_CountrySpecificAttributes_AUS_AustraliaPost_DeliveryPointIdentifier

Australia Post によって開発された 8 桁のコードで、オーストラリアの各配信ポイントを一意に識別できます。

国勢調査
Output_CountrySpecificAttributes_AUS_Census_MeshBlockId

メッシュブロックは、ABS で定義される最小の地理的領域であり、オーストラリア統計地理標準 (ASGS) のより大きなリージョンの構成要素を形成します。住宅、商用、主要生産、公園などの土地用途を広く特定します。

Gnaf
Output_CountrySpecificAttributes_AUS_Gnaf_AddressClass

アドレス要素の組み合わせを使用して構築されるアドレスクラス。値には、 A (エイリアス）、 P (プリンシパル)PP、 (プリンシパルプライマリ）、 PS (プリンシパルセカンダリ）、 AP (エイリアスプライマリ）、 AS (エイリアスセカンダリ) が含まれます。

Output_CountrySpecificAttributes_AUS_Gnaf_GnafPid

永続識別子は、このレコードが表す実際の機能に固有です。永続識別子 (PID) は、各 G-NAF アドレスを一意に識別する 14 文字の英数字文字列です。

Output_CountrySpecificAttributes_AUS_Gnaf_LegalParcelId

G-NAF 内のこのフィールドは、特定の住所に関連付けられた土地区画の一意の識別子を保持するように設計されています。Lot on Plan の説明を表すパーセル ID。政府機関が使用します。形式はさまざまです。

Output_CountrySpecificAttributes_AUS_Gnaf_StatisticalArea1

メッシュブロック全体から構築された地理的領域。SA1s 全体が集約され、統計エリアレベル 2 (SA2s。国勢調査で使用される地理的エリアを表す統計エリアレベル 1 (SA1) フィールド。7 桁の一意のコード。

CanadaPost
Output_CountrySpecificAttributes_CAN_CanadaPost_BuildingType

建物がビジネスビルかアパートビルかを示すコード。有効な値は、 1 = 住宅、 2 = 商用です。

Output_CountrySpecificAttributes_CAN_CanadaPost_RecordType

Address Lookup ファイルと Text Lookup ファイル内のレコードのタイプを定義します。値には、 A1 (高層ビル）、 B1 (大容量レシーバー)C1、 (政府住所)D2、 (LVR ロックボックス提供)E2、 (Government Served by Lock Box)、 F2 (LVR Served by General Delivery)11、 (Street)21、 (Street served by route)32、 (PO Box) が含まれます。

国勢調査
Output_CountrySpecificAttributes_CAN_Census_DisseminationArea

配布エリアを一意に識別します。これは、2 桁の州または地域コード、2 桁の国勢調査部門コード、および 4 桁の配布市外局番で構成されます。

Output_CountrySpecificAttributes_CAN_Census_Division

国勢調査の除算を一意に識別します。CDuid の最初の 2 桁は、州または地域 (PR) を識別します。

Output_CountrySpecificAttributes_CAN_Census_MetropolitanArea

人口中心 (コアと呼ばれる) を中心とする 1 つ以上の隣接する自治体によって形成されます。

Output_CountrySpecificAttributes_CAN_Census_Subdivision

国の国勢調査のサブディビジョンを一意に識別します。州/地域、国勢調査部門、国勢調査部門 (自治体) コードは、標準地理分類 (SGC) を表すために結合されます。

Output_CountrySpecificAttributes_CAN_Census_Tract

CMA/CA 内の国勢調査ルートを識別します。対応する国勢調査都市部または国勢調査集計で各国勢調査路を一意に識別するには、国勢調査路の「名前」の前に 3 桁の CMA/CA コードが必要です。

USPS
Output_CountrySpecificAttributes_USA_Usps_CarrierRoute

USPS がメール配信プロセスをより効率的にするためにグループ化する ZIP コード内の郵送先住所のグループ。ZIP コードが国を異なる地域に分割するのと同じ方法で、キャリアルートはそれらの ZIP コードを分割します。

Output_CountrySpecificAttributes_USA_Usps_DefaultFlag

処理されたレコードが、ZIP + 4 製品の高層、農村ルート、または道路のデフォルトレコードと一致したことを示します。 Y- デフォルトのフラグインジケータが設定されているか、N空白 - 許容範囲です。

Output_CountrySpecificAttributes_USA_Usps_DeliveryPoint_Barcode

ハウス/ボックスの 2 桁の配信ポイント。

Output_CountrySpecificAttributes_USA_Usps_DeliveryPoint_CheckDigit

DPBC 内の他の桁の合計に追加される数値。10 の倍数になります。

Output_CountrySpecificAttributes_USA_Usps_Elot_AscendingDescendingFlag

昇順/降順のコードは、シーケンス番号内のおおよその配信順序を示します。

Output_CountrySpecificAttributes_USA_Usps_Elot_SequenceNumber

Line of Travel (eLOT) シーケンス番号が拡張され、メーラーがキャリアの配信パスに沿った方法でメーリングをソートできるようになりました。キャリアルート内のアドオン範囲に対して行われた配信の最初の発生を示します。

Output_CountrySpecificAttributes_USA_Usps_NonDeliverableRecord

ステージ I ファイルのフィールドは、住所テストの質問が ZIP + 4® 製品のレコードと有効な一致であることを示します。ただし、マッチングは配信不能 (ND) タイプのレコードに対して行われます。 Y- レコードは ND タイプ、空白 - レコードは ND タイプではありません。

Output_CountrySpecificAttributes_USA_Usps_PoBoxOnlyFlag

市区町村の製品の一部には、私書箱のみの配送ゾーンが含まれています。ファイルレイアウトは、既存の ZIP とは異なる著作権詳細コードPとして を使用します。市区町村詳細レコードの 13 番目 (13) の位置Pにある分類コードで、私書箱やその他のタイプのコミュニティへの配送があることを示します。これらのゾーンには、他の形式の郵送はありません。

Output_CountrySpecificAttributes_USA_Usps_RecordType

会社 (F) の一般配送 () の高層化 (G) 私書箱 (H) の農村ルート (P) やストリートレコード (R) などの入力アドレスに一致するアドレスレコードのタイプS。

Output_CountrySpecificAttributes_USA_Usps_RuralRouteDefault

農村ルートの一致を示します。 Y - アドレスが農村ルートレコードに一致しました。 N または空白 - アドレスが農村ルートレコードと一致しませんでした。

Output_CountrySpecificAttributes_USA_Usps_Urbanization

プエルトリコの都市化名。

Output_CountrySpecificAttributes_USA_Usps_ZipValid

有効な郵便番号を示す true/false フラグ。アドレスレコードを Form 3553 に追加できるかどうかを示します。5 桁の検証では、都市の州と郵便番号の最後の行の値が互いに対応している必要があります。

Output_CountrySpecificAttributes_USA_Usps_Zip10

ダッシュ区切り文字付きの 10 桁の郵便番号 (ZIP + 4)。

Output_CountrySpecificAttributes_USA_Usps_Zip9

9 桁の郵便番号 (ZIP + 4)。

国勢調査
Output_CountrySpecificAttributes_USA_Census_BlockId

2020 年国勢調査ブロック ID。

Output_CountrySpecificAttributes_USA_Census_CombinedStatisticalArea_Number

統計領域 (CSA) の合計数。

Output_CountrySpecificAttributes_USA_Census_CombinedStatisticalArea_Name

複合統計領域 (CSA) 名。

Output_CountrySpecificAttributes_USA_Census_CoreBasedStatisticalArea_Number

コアベースの統計領域 (C") 番号。

Output_CountrySpecificAttributes_USA_Census_CoreBasedStatisticalArea_Name

アドレスがあるコアベースの統計領域 (C") の名前。

Output_CountrySpecificAttributes_USA_Census_CountyFipsCode

郡の FIPS コード。

Output_CountrySpecificAttributes_USA_Census_MetropolitanAreaFlag

アドレスがあるコアベース統計エリア (C") が大都市エリアかマイクロポリタンエリア (Y/) かを示しますN。

RoyalMail
Output_CountrySpecificAttributes_GBR_RoyalMail_SubBuilding

アドレスのサブ建物名および/または識別子。

Output_CountrySpecificAttributes_GBR_RoyalMail_ThoroughfareName

住所の通りまたは通りのベース名。

Output_CountrySpecificAttributes_GBR_RoyalMail_DependentThoroughfareName

アドレスの二重依存の大通り。これは、他の名前付き大通り内に名前付き大通りがある場合に使用されます。

Output_CountrySpecificAttributes_GBR_RoyalMail_DependentLocality

アドレスの依存するローカリティ。これは、ローカリティ内に同じまたは類似の名前の通り道がある場合に使用されます。

Output_CountrySpecificAttributes_GBR_RoyalMail_DoubleDependentLocality

アドレスの二重依存ローカリティ。これは、依存ローカリティ内に同じまたは類似の名前を持つ複数の通り道がある場合に使用されます。

Output_CountrySpecificAttributes_GBR_RoyalMail_OrganizationName

住所に登録されている組織の名前。

Output_CountrySpecificAttributes_GBR_RoyalMail_Udprn

Unique Delivery Point Reference Number (UDPRN) は、Royal Mail によって英国内のアドレスに割り当てられた一意の 8 桁のコードです。