Package google.maps.addressvalidation.v1

string

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

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

PostalAddress

住所として表された、後処理済みの住所。

AddressComponent

順序なしリスト。形式が整えられて修正された住所の個々の住所構成要素と、検証情報。これにより、個々のコンポーネントの検証ステータスに関する情報が提供されます。

住所コンポーネントは特定の順序で並べられていません。リスト内の住所の要素の順序を前提としない。

string

正しい形式の郵送先住所に存在することが想定されるが、入力に見つからず、推測もできないコンポーネントのタイプ。たとえば、「Boulder, Colorado, 80301, USA」という入力に対して ['street_number', 'route'] という値を指定します。使用可能なタイプのリストについては、こちらをご覧ください。

注: 不足しているコンポーネントをすでに指定していると思われる場合でも、不足しているコンポーネントのタイプが表示されることがあります。たとえば、入力された住所に建物名は含まれていても、建物番号が含まれていない場合に、この問題が発生することがあります。住所「渋谷区渋谷３丁目　 Shibuya Stream」では、建物名「Shibuya Stream」のコンポーネント タイプは premise ですが、施設番号がないため、missing_component_types には premise が含まれます。

string

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

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

入力のジオコーディングされた位置情報。

住所、緯度/経度の座標、Plus Code を使用するよりも、プレイス ID を使用することをおすすめします。ルート検索やルート案内で座標を使用すると、その座標に最も近い道路にポイントがスナップされます。目的地に迅速かつ安全に到達できる道路ではない可能性があります。また、物件へのアクセス ポイントの近くにないこともあります。また、位置情報をリバース ジオコーディングしても、返された住所が元の住所と一致するとは限りません。

PlusCode

location に対応する Plus Code。

Viewport

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

float

ジオコーディングされた場所のサイズ（メートル単位）。これは、ジオコーディングされた位置情報の粗さを表すもう 1 つの指標ですが、意味的な意味ではなく物理的なサイズで表されます。

string

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

Place 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: 2 番目の電話番号が一致せず、必須ではない
• C1: 2 番目の電話番号が一致していないが必須
• N1: 高層ビルの住所に副番号がない
• M1: プライマリ番号がない
• M3: プライマリ番号が無効です
• P1: 入力された住所の私書箱番号（PO、RR、HC）が欠落している
• P3: 入力された住所の私書箱番号、郵便局の私書箱番号、または軍用私書箱番号が無効です
• F1: 軍施設の住所に一致する入力アドレス
• G1: 一般配達先住所に一致する入力アドレス
• U1: 一意の郵便番号に一致する住所を入力します。
• PB: PBSA レコードに一致する入力アドレス
• RR: DPV が PMB 情報を使用して住所を確認済み
• R1: PMB 情報なしで DPV が確認した住所
• R7: 運送業者ルート R777 または R779 レコード
• IA: 通知済み住所が特定された
• TA: 末尾のアルファベットを削除して一致したプライマリ番号

string

住所が CMRA（商業郵便受取業者）であるかどうかを示します。CMRA とは、クライアントの郵便物を受け取る民間企業です。1 文字を返します。

• Y: アドレスが CMRA である
• N: アドレスが CMRA ではない

string

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

• Y: 住所が空き家である
• N: 住所が空き家ではない

string

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

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

int32

NoStat タイプを示します。理由コードを整数として返します。

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

string

1 つのサイト内の 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 で確認され、セカンダリ番号の情報は存在するものの確認されていないか、プライマリ番号の末尾のアルファベットが 1 つ削除されて 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

拡張ルート（eLOT）番号。

string

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

string

LACSLink の戻りコード。

string

LACSLink インジケーター。

bool

郵便ポストボックスのみの郵便番号。

string

ストリートまたは高層ビルのレコードとスイート情報の照合による脚注。ビジネス名が一致すると、2 番目の電話番号が返されます。

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

string

PMB（私書箱）ユニットの指定子。

string

PMB（私書箱）番号

string

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

• F: FIRM。これは、住所に対して利用可能な最も細かいレベルの一致である、企業レコードとの一致です。
• G: 一般配送。これは、一般配達レコードと一致しています。
• H: 建物 / アパート。これは、建物またはアパートのレコードと一致しています。
• P: 郵便私書箱。これは私書箱に一致しています。
• R: RURAL ROUTE または 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 を指定し、最初の行に番地と町名、2 番目の行に市区町村、都道府県、郵便番号を指定します。

LanguageOptions

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

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

string

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

セッションは、ユーザーが予測入力クエリを実行したときに開始され、ユーザーが場所を選択し、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

配信に関連するその他の情報。Address Validation API に送信されるすべての住所について、metadata が完全に入力される保証はありません。

UspsData

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

Address

プレビュー版: この機能はプレビュー版（一般提供前）です。一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、一般提供前のプロダクトや機能の変更は、他の一般提供前のバージョンと互換性がない場合があります。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 をご覧ください。

PossibleNextAction

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

API レスポンスの解釈的な概要を提供します。これは、今後の対応を決定する際に役立ちます。このフィールドは API レスポンスの他のフィールドから派生したものであり、住所の正確性や配達可能性を保証するものではありません。詳細については、検証ロジックを構築するをご覧ください。

bool

住所の少なくとも 1 つの要素のスペルが修正されました。詳細については、google.maps.addressvalidation.v1.Address.address_components をご覧ください。