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 ではなく、プレイス ID の使用をおすすめします。運転ルートを計算したりルートを計算したりする際に座標を使用すると、その座標に最も近い道路にポイントがスナップされます。この道路は、目的地にすばやくまたは安全に通じる道路ではなく、宿泊施設へのアクセス ポイントの近くにない場合があります。また、場所がリバース ジオコーディングされた場合、返される住所が元の住所と一致する保証はありません。

PlusCode

location に対応する Plus Code。

Viewport

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

float

ジオコーディングされた場所のサイズ（メートル単位）。これも、ジオコードされた位置の大まかな粗さを表しますが、セマンティックな意味ではなく物理的なサイズで表します。

string

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

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

string

入力がジオコーディングされた場所のタイプ（複数可）。たとえば、['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: 予備の電話番号が一致せず、必須ではない
• C1: 2 番目の番号が一致しませんが、入力は必須です
• N1: 高層ビルの住所に予備の番号がありません
• M1: メインの電話番号がありません
• M3: メインの電話番号が無効です
• P1: 入力された住所の PO、RR、または HC の箱番号が入力されていません
• P3: 入力した住所の PO、RR、または HC のボックス番号が無効です
• F1: 入力住所が軍施設の住所と一致する
• G1: 入力住所が一般的な配送先住所と一致している
• U1: 入力された住所が一意の郵便番号に一致
• PB: 入力アドレスが PBSA レコードと一致
• RR: DPV 確認済みアドレスと PMB 情報
• R1: DPV 確認済みアドレス（PMB 情報なし）
• 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（大学、軍事、その他のタイプ）- USPS がデータに組み込んだ ZIP + 4 レコード。
• 5: Regular - 配信を受信していないアドレスであり、そのアドレスは配信の可能性があるものとしてカウントされないことを示します。
• 6: 二次必須 - この住所には二次情報が必要です。

string

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

• Y: メールは、サイトの 1 つの受信ボックスに配信されます。
• N: メールは、サイトの 1 つの受信者に配信されません。

string

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

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

string

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

• Y: メール配信は毎日行われません。
• N: メール配信が毎日行われるわけではない。

int32

配信されない日を識別する整数値。ビットフラグを使用して調べることができます。 0x40 – 日曜日は未配送日 0x20 – 月曜日は未配送日 0x10 – 火曜日は未配送日 0x08 – 水曜日は未配送日 0x04 – 木曜日は未配送日 0x02 – 金曜日は未配送日 0x02 – 金曜日は未配送日 0x1

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

街路や高層ビルのレコードと部屋情報を照合する際の脚注。ビジネス名の一致が見つかった場合は、予備の番号が返されます。

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

string

PMB（Private Mail Box）ユニット指定子。

string

PMB（個人用メールボックス）番号

string

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

• F: FIRM。これは、住所に使用できる最高レベルの一致である Firm Record との一致です。
• G: 一般的な配信。これは一般配信レコードと一致します。
• H: 建物 / マンション。これはビルディングまたはアパートの記録と一致しています。
• P: オフィス用ボックス。これは私書箱と一致します。
• R: RURAL ROUTE or HIGHWAY CONTRACT: Rural Route または Highway Contract のいずれかの記録に一致します。どちらにもボックス番号の範囲が関連付けられている可能性があります。
• S: STREET RECORD: 有効なメインの数値範囲を含むストリート レコードと一致します。

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 を使用するか、2 つ以上の google.type.PostalAddress.address_lines を指定して、1 行目に番地と名前、2 行目に市区町村、都道府県、郵便番号を含めることをおすすめします。

LanguageOptions

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

レスポンスに追加の情報を含めるために Address Validation API を有効にします。

string

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

セッションは、ユーザーが Autocomplete クエリを実行すると開始し、場所を選択して Place Details または Address Validation への呼び出しを行うと終了します。各セッションには複数の Autocomplete クエリがあり、その後に 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 が住所を完全にvalidateできる粒度レベル。たとえば、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 をご覧ください。