Package google.maps.addressvalidation.v1

string

住所が存在する地域の住所形式ルールに従って、1 行の住所としてフォーマットされた、後処理済みの住所。

注: このアドレスの形式は、postal_address フィールドのアドレスの形式と一致しない場合があります。たとえば、postal_address は常に国を 2 文字の region_code（「US」や「NZ」など）として表します。一方、このフィールドでは、国名の長い形式（「米国」や「ニュージーランド」など）が使用されます。

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

解決できなかった入力内のトークン。住所の有効な部分として認識されなかった入力である可能性があります。たとえば、「Parcel 0000123123 & 0000456456 Str # Guthrie Center IA 50115 US」のような入力の場合、未解決のトークンは ["Parcel", "0000123123", "&", "0000456456"] のようになります。

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

入力がジオコーディングされた場所のタイプ。たとえば、['locality', 'political'].タイプの完全なリストについては、こちらをご覧ください。

bool

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

string

場所のグローバル（完全）コード（「9FWM33GV+HQ」など）。8000 分の 1 x 8000 分の 1 度（約 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 、郵便番号、ZIP+4 のすべての桁を足すと、10 で割り切れる数値になります。

string

DPV 確認の有効な値。単一の文字を返すか、値を返しません。

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

string

配送ポイントの検証に関する脚注。複数の脚注を同じ文字列に連結できます。

• AA: ZIP+4 ファイルに一致する入力アドレス
• A1: 入力アドレスが ZIP+4 ファイルと一致しなかった
• BB: DPV に一致（すべてのコンポーネント）
• CC: 予備の電話番号が一致せず、必須ではない
• C1: 2 番目の番号が一致しませんが、入力は必須です
• N1: 高層ビルの住所に副番号がない
• M1: プライマリ番号がない
• M3: プライマリ番号が無効です
• P1: 入力された住所の私書箱番号（PO、RR、HC）が欠落している
• P3: 入力した住所の PO、RR、または HC のボックス番号が無効です
• 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 タイプを示します。理由コードを整数として返します。

• 1: IDA（Internal Drop Address）– USPS から直接郵便物を受け取らずに、そのサービスを提供する持ち込み住所に配送される住所。
• 2: CDS - まだ配達できない住所。たとえば、区画とプライマリ番号が決定されているが、居住可能な建物がまだ存在しない新しい分譲地などです。
• 3: 競合 - 実際に DPV 確認が行われないアドレス。
• 4: CMZ（大学、軍隊、その他の種類）- USPS がデータに組み込んだ ZIP + 4 レコード。
• 5: 通常 - 配送が行われていない住所を示します。これらの住所は配送の対象としてカウントされません。
• 6: セカンダリ必須 - 住所にセカンダリ情報が必要です。

string

フラグ は、メールがサイト上の 1 つの受信可能なものに配信されることを示します。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 を一致させセカンダリ情報を必須とするためにプライマリ番号の末尾のアルファが 1 つドロップされました。
• 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

拡張ルート（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。これは、住所に対して利用可能な最も細かいレベルの一致である、企業レコードとの一致です。
• G: 一般配送。これは、一般配達レコードと一致しています。
• H: 建物 / アパート。これは、建物またはアパートのレコードと一致しています。
• P: オフィス用ボックス。これは私書箱に一致しています。
• R: RURAL ROUTE or HIGHWAY CONTRACT: Rural Route または Highway Contract のいずれかの記録に一致します。どちらにもボックス番号の範囲が関連付けられている可能性があります。
• S: ストリート レコード: 有効なプライマリ番号範囲を含むストリート レコードに一致します。

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 を「Puerto Rico」（大文字と小文字は区別されません）または「PR」として指定する必要があります。

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

LanguageOptions

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

Address Validation API がレスポンスに追加情報を含めることができるようにします。

string

省略可。請求目的で Autocomplete セッションを識別する文字列。URL とファイル名セーフ、長さが 36 文字以下の base64 文字列にする必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。

セッションは、ユーザーが Autocomplete クエリを実行すると開始し、場所を選択して Place Details または Address Validation への呼び出しを行うと終了します。セッションによっては、複数のオートコンプリート クエリが入力された後に、1 つの Place Details リクエストまたは Address Validation リクエストが実行される場合もあります。セッション内の各リクエストに使用される認証情報は、同じ Google Cloud コンソール プロジェクトに属している必要があります。セッションが終了すると、トークンは無効になります。アプリでは、セッションごとに新しいトークンを生成する必要があります。sessionToken パラメータを省略する場合や、セッション トークンを再利用する場合は、セッション トークンが指定されていない場合と同様にセッションが課金されます（各リクエストが個別に課金されます）。

注: Address Validation は Autocomplete（新）API を使用するセッションでのみ使用できます。Autocomplete API では使用できません。詳しくは、https://developers.google.com/maps/documentation/places/web-service/session-pricing をご覧ください。

ValidationResult

住所確認の結果。

string

このレスポンスを識別する UUID。住所の再確認が必要な場合は、この UUID を新しいリクエストに含める必要があります。

Verdict

全体的な判定結果のフラグ

Address

ジオコードではなく、住所自体に関する情報。

Geocode

住所がジオコーディングされた場所と場所に関する情報。

AddressMetadata

配信に関連するその他の情報。metadata は、Address Validation API に送信されるすべての住所に対して完全に入力されるとは限りません。

UspsData

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

Address

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

英語に翻訳された住所。

変換された住所は、API 入力として再利用できません。ユーザーが母国語で、最初に提供した住所の検証を確認または拒否できるように、このサービスが提供されています。

住所の一部に英語の翻訳がない場合は、その部分はラテン文字を使用する代替言語で返されます。代替言語の選択方法については、こちらをご覧ください。住所の一部にラテン文字を使用する言語での翻訳や音訳がない場合は、その部分は住所に対応するローカル言語で返されます。

この出力を有効にするには、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 が住所を完全に検証できる粒度レベル。たとえば、validation_granularity が PREMISE の場合、PREMISE 以上のレベルのすべての住所コンポーネントを検証できます。

住所の構成要素ごとの検証結果は google.maps.addressvalidation.v1.Address.address_components にあります。

Granularity

geocode の粒度に関する情報。これは、ジオコーディングされた位置の精度を意味します。

これは、上記の validation_granularity とは異なる場合があります。たとえば、データベースにはアパートの番号が記録されているものの、大きなアパート団地内のアパートの正確な位置が記録されていない場合があります。この場合、validation_granularity は SUB_PREMISE ですが、geocode_granularity は PREMISE になります。

bool

未解決のトークンがなく、予期しない住所コンポーネントや不足している住所コンポーネントがない場合、住所は完全と見なされます。設定されていない場合、値が false であることを示します。詳細については、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 をご覧ください。