Package google.maps.addressvalidation.v1

string

住所がある地域の住所形式ルールに従って、1 行で住所の形式をとった後処理された住所。

PostalAddress

郵送先住所として表される、後処理済みの住所。

AddressComponent

順序なしリスト。書式設定および修正された住所の個々の住所コンポーネントと検証情報。これにより、個々のコンポーネントの検証ステータスに関する情報が得られます。

住所コンポーネントの順番は決まっていません。リスト内の住所コンポーネントの順序は仮定しないでください。

string

正しい形式の送付先住所に存在することが期待されているが、入力には含まれず、推定もできなかったコンポーネントのタイプ。このタイプのコンポーネントは、formatted_address、postal_address、または address_components に存在しません。たとえば、「Boulder, Colorado, 80301, USA」のような入力の場合は、['street_number', 'route'] のようにします。利用可能なタイプのリストについては、こちらをご覧ください。

string

address_components に存在するが、正常であることを確認できなかったコンポーネントのタイプ。このフィールドは便宜上提供されています。その内容は、confirmation_level が CONFIRMED でないか、inferred フラグが true に設定されていないすべてのコンポーネントの型を見つけるために、address_components を反復処理するのと同じです。利用可能なタイプのリストについては、こちらをご覧ください。

string

解決できなかった入力内のトークン。これは、住所の有効な部分として認識されなかった入力である可能性があります（たとえば、「123235253253 Main St, San Francisco, CA, 94105」のような入力では、未解決のトークンは有効な番地とは見なされないため、["123235253253"] のようになります。

ComponentName

このコンポーネントの名前。

string

住所コンポーネントのタイプ。利用可能なタイプのリストについては、表 2: プレイス サービスで返されるその他のタイプをご覧ください。

ConfirmationLevel

コンポーネントが正しいことの確実性を示します。

bool

コンポーネントが入力に含まれなかったものの、住所の位置から推測され、完全な住所に対して提供されるはずであることを示しています。

bool

コンポーネント名のスペルミスが修正されたことを示します。API では、「centre」を「center」に変更する場合など、スペルのバリエーション間での変更が必ず報告されるわけではありません。また、「Amphitheater Pkwy」を「Amphitheatre Pkwy」に変更した場合など、よくあるスペルミスが報告されるわけではありません。

bool

コンポーネントの名前がまったく別の名前に置き換えられたことを示します。たとえば、間違った郵便番号が住所に適切な名前に置き換えられた場合などです。これは外観上の変更ではなく、入力コンポーネントが別のものに変更されました。

bool

指定された地域の住所には含まれていない住所コンポーネントを示します。これは、入力の一部であったという理由だけで保持しています。

bool

ビジネスの住所であることを示します。未設定の場合、値が不明であることを示します。

bool

私書箱の住所を表します。未設定の場合、値が不明であることを示します。

bool

これが住宅の住所であることを示します。未設定の場合、値が不明であることを示します。

string

名前のテキスト。たとえば、番地には「5th Avenue」、番地には「1253」と入力します。

string

BCP-47 言語コード。コンポーネント名が言語（番地など）に関連付けられていない場合、存在しません。

LatLng

入力のジオコーディングされた場所。

プレイス ID は、住所、緯度/経度の座標、Plus Code よりも優先して使用することをおすすめします。ルート選択や運転ルートの計算で座標を使用すると、ポイントは常にその座標に最も近い道路にスナップされます。目的地に迅速かつ安全にアクセスできる道路ではなく、宿泊施設への出入り口の近くにないとは限りません。また、ビジネスがリバース ジオコーディングされても、返される住所が元の住所と同じになるとは限りません。

PlusCode

location に対応する Plus Code。

Viewport

ジオコーディングされた場所の境界。

float

ジオコーディングされた場所のサイズ（メートル単位）。これはジオコーディングされた場所の粗さのもう 1 つの尺度ですが、意味論的意味よりも物理サイズで示されます。

string

この入力でジオコーディングする場所の PlaceID。

プレイス ID について詳しくは、こちらをご覧ください。

string

入力がジオコーディングされた場所のタイプ（1 つ以上）。たとえば、['locality', 'political'].種類の一覧はこちらでご確認いただけます。

bool

プレビュー: 英語で google.maps.addressvalidation.v1.Address を返します。詳しくは、google.maps.addressvalidation.v1.ValidationResult.english_latin_address をご覧ください。

string

場所のグローバル（完全）コード。「9FWM33GV+HQ」など、1/8, 000 x 1/8,000 度の領域（約 14 x 14 メートル）を表します。

string

場所の複合コード（「33GV+HQ, Ramberg, Norway」など）。グローバル コードの接尾辞が含まれ、接頭辞は参照エンティティのフォーマットされた名前に置き換えられます。

ValidationConclusion

必須。一連の検証試行の結果。

このフィールドが VALIDATION_CONCLUSION_UNSPECIFIED に設定されている場合、INVALID_ARGUMENT エラーが返されます。

string

必須。このフィードバックの対象となる回答の ID。これは、一連の住所検証の試行における最初のレスポンスの [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] である必要があります。

string

住所の 1 行目。

string

会社名。

string

住所の 2 行目。

string

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

string

市区町村 + 都道府県 + 郵便番号。

string

市町村名。

string

2 文字の州コード。

string

郵便番号。例: 10009。

string

4 桁の郵便番号の拡張コード（例: 5023）。

UspsAddress

USPS の標準化された住所です。

string

2 桁の配送先コード

string

配送先のチェック ディジット。この番号は、機械的にスキャンされたメールの場合、delivery_point_barcode の末尾に追加されます。Delivery_point_barcode、delivery_point_check_digit、postal code、ZIP+4 のすべての桁を加算すると、10 で割り切れる数値になります。

string

DPV の確認に使用できる値です。1 文字を返すか、値を返しません。

• N: プライマリとセカンダリの番号情報が DPV の確認に失敗しました。
• D: 住所がメインの電話番号でのみ DPV で確認され、予備の電話番号情報がありません。
• S: 住所はメインの電話番号でのみ DPV 確認済みで、予備の電話番号情報は存在しますが確認されていません。
• Y: メインの番号と予備の番号で DPV が確認された住所です。
• 空: レスポンスに dpv_confirmation 値が含まれていない場合、住所は DPV 確認用に送信されていません。

string

提供ポイントの検証の脚注複数の脚注を同じ文字列の中でつなぎ合わせることができます。

• AA: ZIP+4 ファイルに一致する入力アドレス
• A1: 入力アドレスが ZIP+4 ファイルと一致しませんでした
• BB: DPV に一致（すべてのコンポーネント）
• CC: 2 番目の番号が一致せず、必須ではありません
• C1: 一致しないが必須となるセカンダリ番号
• N1: 高層住所に予備の番号がありません
• M1: メインの電話番号がありません
• M3: メインの番号が無効です
• P1: PO、RR、HC の箱番号を入力していない
• P3: 入力した住所に PO、RR、HC Box 番号が無効です
• F1: 入力住所が軍施設の住所と一致しました
• G1: 一般的な配送先住所と一致する入力住所
• U1: 一意の郵便番号に一致する入力住所
• PB: PBSA レコードと一致した入力アドレス
• RR: DPV が PMB 情報を含む住所を確認
• R1: PMB 情報のない DPV 確認済み住所
• R7: Carrier Route R777 または R779 レコード
• IA: 通知済みの住所を特定しました
• TA: 末尾のアルファを削除することで一致するメインの数値

string

住所が CMRA（Commercial Mail Received Agency）（顧客の郵便物が届く民間企業）かどうかを指定します。1 文字を返します。

• Y: アドレスは CMRA
• N: このアドレスは CMRA ではありません

string

この場所は空ですか？1 文字を返します。

• Y: この住所が空です
• N: このアドレスは空ではありません

string

これは統計アドレスがありませんか、それとも有効な住所ですか？データを継続的に占有していない住所や、USPS がサービスを提供していない住所とは、1 文字を返します。

• Y: このアドレスは有効ではありません
• N: このアドレスはアクティブです

int32

NoStat 型を示します。理由コードを int として返します。

• 1: IDA（Internal Drop Address）– USPS から直接メールを受け取らないが、サービスを提供するドロップ アドレスに配信されるアドレス。
• 2: CDS - まだ納品されていない住所。たとえば、ロットと主要な番号が決まっているものの、占有率の構造がまだ存在しない新しい区分などです。
• 3: 衝突 - 実際には DPV で確認していないアドレス。
• 4: CMZ（College, Military and Other Types） - ZIP + 4 件のレコードが USPS によりデータに反映されています。
• 5: レギュラー - この住所が配達を受けていないことを示し、配達可能な住所としてカウントされません。
• 6: 二次必須 - この住所には二次情報が必要です。

string

フラグは、サイトの単一の受信可能にメールが配信されたことを示します。1 文字を返します。

• Y: サイトの 1 つの受信可能先にメールが配信されます。
• N: サイトの 1 つの受信可能にメールが配信されません。

string

番地に郵便物が配送されていないことを示します。1 文字を返します。

• Y: 郵便物は番地に配達されていません。
• N: 郵便は番地に配送されます。

string

フラグは、メールの配信が毎日行われないことを示します。1 文字を返します。

• Y: メール配信は毎週行われるわけではありません。
• N: メール配信がすべての曜日に行われないことを示すわけではありません。

int32

配達不能の日数を示す整数。次のビットフラグを使用して照会できます。0x40 – 日曜日は配達不能の日 0x20 – 月曜日は配達不能の日 0x10 – 火曜日は配達不能の日 0x08 – 水曜日は配達不能の日 0x04 – 木曜日は配達不能の日 0x02 – 金曜日は配達不能の日 0x01

string

フラグはドアにアクセス可能であるものの、セキュリティ上の懸念により荷物が放置されていないことを示します。1 文字を返します。

• Y: セキュリティ上の懸念により、荷物は発送されません。
• N: セキュリティ上の懸念から荷物が置かれないことを示す兆候はありません。

string

アドレスが PBSA レコードと一致したことを示します。1 文字を返します。

• Y: アドレスが PBSA レコードと照合されました。
• N: アドレスが PBSA レコードと一致しませんでした。

string

USPS が郵便物を配達できない住所であることを示すフラグ。1 文字を返します。

• Y: ドアにアクセスできません。
• N: ドアにアクセスできることを示すものではありません。

string

同じ住所に対して複数の DPV 戻りコードが有効であることを示します。1 文字を返します。

• Y: メインの番号と予備の番号で DPV が確認された住所です。
• N: プライマリとセカンダリの番号情報が DPV の確認に失敗しました。
• S: メインの番号でのみ住所が DPV 確認済みで、確認されていない予備の番号情報が存在していたか、DPV と一致するよう予備の情報が必要になるように、メインの番号の末尾の単一のアルファが削除されています。
• D: 住所がメインの電話番号でのみ DPV で確認され、予備の電話番号情報がありません。
• R: 住所は確認されていますが、ファントム ルート R777 および R779 に割り当てられており、USPS 配送が指定されていません。

string

運送業者のルートコード。1 文字の接頭辞と 3 桁のルート指定子からなる 4 文字のコード。

接頭辞:

• C: 運送ルート（または都市ルート）
• R: 地方道路
• H: 高速道路契約ルート
• B: 私書箱セクション
• G: 一般的な配信の単位

string

運送業者のルート送料並べ替えインジケーター。

bool

配送先住所は一致していますが、EWS ファイルには完全一致がまもなく利用可能になることを示しています。

string

郵便局の主要都市。

string

メインの郵便局の都道府県。

string

都市の略称。

string

FIPS の郡コード。

string

国名。

string

エンハンスト Line of Travel（eLOT）番号。

string

eLOT 昇順/降順フラグ（A/D）。

string

LACSLink 戻りコード。

string

LACSLink インジケーター。

bool

私書箱のみの郵便番号。

string

番地や高層ビルのレコードとスイートの情報とのマッチングに関する脚注。一致するビジネス名が見つかった場合は、2 番目の番号が返されます。

• A: SuiteLink レコードの一致、ビジネスの住所が改善されました。
• 00: 一致なし。ビジネスの住所が改善されません。

string

PMB（Private Mail Box）の単位指定子。

string

PMB（私書箱）番号

string

入力住所に一致する住所レコードのタイプ。

• F: FIRM. これは Firm Record（住所で使用できる最高レベルの一致）と一致します。
• G: 一般納品。これは一般配達レコードと一致します。
• H: 建築 / アパート。ビルディングまたはアパートのレコードと一致します。
• P: オフィス ボックスを投稿します。これは私書箱と一致します。
• R: RURAL ROUTE または HIGHWAY CONTRACT: これは、RURAL ROUTE または HIGHWAY CONTRACT のいずれかのレコードに一致します。どちらのレコードにも、Box 番号の範囲が関連付けられている可能性があります。
• S: STREET RECORD: 有効なプライマリ数値範囲を含む Street レコードに一致します。

bool

デフォルトの住所が見つかったものの、より具体的な住所が存在することを示すインジケーター。

string

USPS データの取得に関するエラー メッセージです。人為的に作成された住所が検出されたために USPS の処理が停止したときに入力されます。

このエラーがある場合、USPS データ フィールドが入力されていない可能性があります。

bool

リクエストが CASS で処理されたことを示すインジケーター。

PostalAddress

必須。検証される住所。書式設定されていない住所は、address_lines で送信する必要があります。

この入力のフィールドの合計長は 280 文字以内にする必要があります。

サポートされているリージョンについては、こちらをご覧ください。

入力アドレスの language_code 値は将来の使用のために予約されており、現在は無視されています。検証済みの住所の結果は、システムによって識別された指定された住所の優先言語に基づいて入力されます。

Address Validation API は、recipients と organization の値を無視します。これらのフィールドの値は破棄され、返されません。設定しないでください。

string

最初の住所確認リクエストでは、このフィールドを空にする必要があります。1 つの住所を完全に検証するために追加のリクエストが必要な場合（最初の検証後にユーザーが行った変更を再検証する必要がある場合など）、各フォローアップ リクエストで、検証シーケンスの最初のレスポンスの response_id をこのフィールドに入力する必要があります。

bool

USPS CASS 互換モードを有効にします。これは google.maps.addressvalidation.v1.ValidationResult の google.maps.addressvalidation.v1.ValidationResult.usps_data フィールドにのみ影響します。注: プエルトリコの住所に対して USPS の CASS 対応リクエストを行う場合は、address の google.type.PostalAddress.region_code を「PR」として指定するか、address の google.type.PostalAddress.administrative_area を「プエルトリコ」（大文字と小文字を区別しない）または「PR」として指定する必要があります。

コンポーネント化された address を使用するか、1 行目に番地と名称を含み、2 行目に市区町村、都道府県、郵便番号を含む google.type.PostalAddress.address_lines を少なくとも 2 つ指定することをおすすめします。

LanguageOptions

（省略可）プレビュー: この機能はプレビュー版（pre-GA）です。一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、一般提供前のプロダクトや機能の変更は、他の一般提供前のバージョンと互換性がない場合があります。pre-GA のサービスには、Google Maps Platform サービス固有の規約 が適用されます。詳細については、リリース ステージの説明をご覧ください。

Address Validation API がレスポンスに追加の情報を含めることを可能にします。

ValidationResult

住所検証の結果。

string

このレスポンスを識別する UUID。アドレスの再検証が必要な場合は、新しいリクエストにこの UUID を付ける必要があります。

Verdict

全体の判定フラグ

Address

ジオコードではなく、住所そのものに関する情報。

Geocode

住所のジオコーディングを行った場所と場所に関する情報。

AddressMetadata

提供状況に関連するその他の情報。metadata で、Address Validation API に送信されるすべての住所が完全に入力されるとは限りません。

UspsData

USPS により提供される追加の配送フラグ。リージョン US と PR でのみ提供されます。

Address

プレビュー: この機能はプレビュー版（pre-GA）です。一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、一般提供前のプロダクトや機能の変更は、他の一般提供前のバージョンと互換性がない場合があります。pre-GA のサービスには、Google Maps Platform サービス固有の規約 が適用されます。詳細については、リリース ステージの説明をご覧ください。

英語に翻訳された住所。住所に英語の翻訳がない場合、ラテン文字を使用した代替言語でその住所が返されます。代替言語の選択方法については、こちらをご覧ください。住所にラテン文字を使用する言語の翻訳や文字変換がない場合は、住所に関連付けられた現地言語でその部分が返されます。

この出力は、google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address フラグを使用して有効にしました。

注: english_latin_address の google.maps.addressvalidation.v1.Address.unconfirmed_component_types フィールドと english_latin_address.address_components の google.maps.addressvalidation.v1.AddressComponent.confirmation_level フィールドには値が入力されません。

Granularity

入力アドレスの粒度。これは入力住所を解析した結果であり、検証シグナルは提供しません。検証シグナルについては、下記の validation_granularity をご覧ください。

たとえば、入力された住所に特定のアパート番号が含まれている場合、ここでの input_granularity は SUB_PREMISE になります。データベースでアパート名を照合できない場合や、アパート番号が無効な場合、validation_granularity は PREMISE 以下になる可能性が高くなります。

Granularity

API が住所を完全にvalidateできる粒度。たとえば、validation_granularity が PREMISE の場合、PREMISE 以上の精度レベルを持つすべての住所コンポーネントを検証できることを示します。

住所ごとのコンポーネント検証の結果は google.maps.addressvalidation.v1.Address.address_components にあります。

Granularity

geocode の粒度に関する情報。これは、ジオコーディングされた位置情報がどの程度粗いか、または細かいかを示すセマンティックな意味と理解できます。

これは、上記の validation_granularity とは異なる場合があります。たとえば、データベースにアパート番号の存在が記録されていても、大きなマンション内にあるアパートの正確な位置情報はわからない場合があります。この場合、validation_granularity は SUB_PREMISE になりますが、geocode_granularity は PREMISE になります。

bool

未解決のトークンや、予期しない住所コンポーネント、欠落している住所コンポーネントがない場合、住所は完全とみなされます。詳細については、missing_component_types、unresolved_tokens、または unexpected フィールドをご覧ください。

bool

少なくとも 1 つの住所コンポーネントを分類または検証できません。詳しくは、google.maps.addressvalidation.v1.Address.address_components をご覧ください。

bool

入力には含まれていなかった住所コンポーネントが 1 つ以上推測（追加）されました。詳細については、google.maps.addressvalidation.v1.Address.address_components をご覧ください。

bool

少なくとも 1 つの住所コンポーネントが置き換えられました。詳しくは、google.maps.addressvalidation.v1.Address.address_components をご覧ください。