Method: validateAddress

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

integer

PostalAddress のスキーマ リビジョン。0 以外の値を指定すると、API から INVALID_ARGUMENT エラーが返されます。

string

（省略可）住所の国 / 地域に対応する CLDR 地域コード。詳しくは、https://cldr.unicode.org/ と https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html をご覧ください。（例: スイスは「CH」）。地域コードを指定しない場合は、住所から推測されます。最適なパフォーマンスを得るために、わかっている場合は地域コードを含めることをおすすめします。地域が一致しない、または繰り返されていると、パフォーマンスが低下する可能性があります。たとえば、addressLines にすでに地域が含まれている場合は、このフィールドに地域コードを再度指定しないでください。サポートされるリージョンについては、よくある質問をご覧ください。

string

入力住所の言語コードは将来の使用のために予約されており、現在は無視されています。API は、住所がある場所の適切な言語で住所を返します。

string

（省略可）住所の郵便番号。国によっては郵便番号が使用されていない場合や、指定する必要がない場合もありますが、使用されている場合は住所の他の部分と組み合わせて追加の検証を行うことができます（例: 米国での州と郵便番号の検証）。

string

（省略可）国固有の付加的な並べ替えコード。ほとんどの地域では、これは使用されていません。使用されている場合、値は「CEDEX」のような文字列か（その後に数字を付加した「CEDEX 7」のような形式の場合もあります）、数字のみとなります。たとえば、ジャマイカの「セクターコード」、マラウイの「配達区域インジケーター」、コートジボワールの「郵便局インジケーター」などがこれに該当します。

string

（省略可）その国 / 地域の郵便住所に使用される最上位の行政区域。たとえば、州、省、都道府県などがこれに該当します。特にスペインでは、これは自治州ではなく県になります（例: 「カタルーニャ」ではなく「バルセロナ」）。州や県などの行政区域が郵便住所に使用されない国もあります。たとえば、スイスではこの項目を空のままにします。

string

（省略可）通常は住所の市区町村の部分を指します。たとえば、米国の市、イタリアのコムーネ、英国の郵便町名などがこれに該当します。地域区分が適切に定義されていないところや、この構造にうまく適合しない地域では、locality を空のままにして addressLines を使用してください。

string

（省略可）住所の市区町村部分より下位の区分。たとえば、字、特別区、地区などがこれに該当します。

string

必須。構造化されていない住所の下位部分を記述する行。

addressLines の値は型情報を持たず、1 つのフィールドに複数の値が含まれることがあるため（「Austin, TX」など）、行の順序が明確であることが重要です。住所の行の順序は、住所の国/地域の「封筒の順序」にする必要があります。

住所の最小許容構造表現は、addressLines に配置されたすべての情報で構成されます。regionCode が指定されていない場合、住所は住所行から推測されます。

完全に構造化されていない住所を扱うには、（住所のどの部分が地域区分や行政区域なのかを推測するのではなく）addressLines のみを含む住所を作成してからジオコーディングすることをおすすめします。

string

このフィールドは設定しないでください。Address Validation API では現在使用されていません。現時点では、このフィールドが設定されているリクエストが API で拒否されることはありませんが、情報は破棄され、レスポンスで返されません。

string

このフィールドは設定しないでください。Address Validation API では現在使用されていません。現時点では、このフィールドが設定されているリクエストが API で拒否されることはありませんが、情報は破棄され、レスポンスで返されません。

{
  "returnEnglishLatinAddress": boolean
}

boolean

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

{
  "verdict": {
    object (Verdict)
  },
  "address": {
    object (Address)
  },
  "geocode": {
    object (Geocode)
  },
  "metadata": {
    object (AddressMetadata)
  },
  "uspsData": {
    object (UspsData)
  },
  "englishLatinAddress": {
    object (Address)
  }
}

object (Verdict)

全体の判定フラグ

object (Address)

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

object (Geocode)

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

object (AddressMetadata)

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

object (UspsData)

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

object (Address)

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

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

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

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

{
  "inputGranularity": enum (Granularity),
  "validationGranularity": enum (Granularity),
  "geocodeGranularity": enum (Granularity),
  "addressComplete": boolean,
  "hasUnconfirmedComponents": boolean,
  "hasInferredComponents": boolean,
  "hasReplacedComponents": boolean
}

enum (Granularity)

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

たとえば、入力住所に特定のマンション番号が含まれている場合、inputGranularity は SUB_PREMISE になります。データベース内のアパート番号が一致しない場合、またはアパート番号が無効な場合、validationGranularity は PREMISE 以下である可能性が高くなります。

enum (Granularity)

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

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

enum (Granularity)

geocode の粒度に関する情報。これは、ジオコーディングされた位置情報がどの程度粗いかまたは詳細であるかという意味論的意味として理解することができます。

これは、上記の validationGranularity とは異なる場合があります。たとえば、当社のデータベースには、アパート番号の存在が記録されていても、大きなマンションの集合住宅の正確な場所はわからない場合があります。この場合、validationGranularity は SUB_PREMISE になりますが、geocodeGranularity は PREMISE になります。

boolean

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

boolean

分類または検証ができない住所コンポーネントが 1 つ以上あります。詳しくは、google.maps.addressvalidation.v1.Address.address_components をご覧ください。

boolean

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

boolean

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

{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}

string

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

object (PostalAddress)

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

object (AddressComponent)

順序なしリスト。書式設定および修正された住所に含まれる個々の住所コンポーネントと検証情報。個々のコンポーネントの検証ステータスに関する情報を確認できます。

住所コンポーネントは特定の順序で並べられるわけではありません。リスト内の住所コンポーネントの順序は仮定しないでください。

string

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

string

addressComponents に存在するが、正確であることを確認できなかったコンポーネントのタイプ。このフィールドは便宜上用意されており、その内容は addressComponents を反復処理して confirmationLevel が CONFIRMED でないか、inferred フラグが true に設定されていないすべてのコンポーネントの型を検出する場合と同じです。使用可能なタイプのリストについては、こちらをご覧ください。

string

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

{
  "componentName": {
    object (ComponentName)
  },
  "componentType": string,
  "confirmationLevel": enum (ConfirmationLevel),
  "inferred": boolean,
  "spellCorrected": boolean,
  "replaced": boolean,
  "unexpected": boolean
}

object (ComponentName)

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

string

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

enum (ConfirmationLevel)

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

boolean

コンポーネントは入力の一部ではなかったものの、住所の場所であると推測され、完全な住所に対して提供されるべきだと思われることを示します。

boolean

コンポーネント名のスペルミスの修正を示します。API は、「centre」を「center」に変更するなど、あるスペルのバリエーションから別のスペルへの変更に必ずフラグを立てるわけではありません。また、「Amphitheater Pkwy」を「Amphitheatre Pkwy」に変更するような一般的なスペルミスが必ず検出されるわけではありません。

boolean

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

boolean

特定の地域の郵便物の宛先に含まれない住所コンポーネントを示します。これは、インプットの一部であるという理由だけで保持されています。

{
  "text": string,
  "languageCode": string
}

string

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

string

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

{
  "location": {
    object (LatLng)
  },
  "plusCode": {
    object (PlusCode)
  },
  "bounds": {
    object (Viewport)
  },
  "featureSizeMeters": number,
  "placeId": string,
  "placeTypes": [
    string
  ]
}

object (LatLng)

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

住所、緯度と経度の座標、Plus Codes よりもプレイス ID の使用をおすすめします。ルート選択や運転ルートの計算に座標を使用すると、その座標に最も近い道路にポイントが常にスナップされます。目的地に早くまたは安全につながっていない道路もあります。また、宿泊施設へのアクセス ポイントから遠く離れている場合もあります。また、ビジネスをリバース ジオコーディングした場合、返される住所が元の住所と一致する保証はありません。

object (PlusCode)

location に対応する plus code。

object (Viewport)

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

number

ジオコーディングされた場所のサイズ（メートル単位）。これは、ジオコーディングされた場所のおおまかさを表す別の尺度ですが、意味論的意味ではなく物理サイズで表現されます。

string

この入力によってジオコーディングされる場所の PlaceID。

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

string

入力がジオコーディングされた場所のタイプ（複数可）。たとえば、['locality', 'political'].タイプの一覧については、こちらをご覧ください。

{
  "latitude": number,
  "longitude": number
}

number

緯度（度単位）。範囲 [-90.0, +90.0] 内になければなりません。

number

経度（度単位）。範囲 [-180.0, +180.0] 内になければなりません。

{
  "globalCode": string,
  "compoundCode": string
}

string

場所のグローバル（完全）コード。例: 1/8, 000 x 1/8,000 度の領域（14 x 14 m 以下）を表す「9FWM33GV+HQ」。

string

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

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

必須。ビューポートの下限。

object (LatLng)

必須。ビューポートの最高点。

{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}

boolean

ビジネスの住所であることを示します。設定されていない場合は、値が不明であることを示します。

boolean

私書箱の住所を示します。設定されていない場合は、値が不明であることを示します。

boolean

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

{
  "standardizedAddress": {
    object (UspsAddress)
  },
  "deliveryPointCode": string,
  "deliveryPointCheckDigit": string,
  "dpvConfirmation": string,
  "dpvFootnote": string,
  "dpvCmra": string,
  "dpvVacant": string,
  "dpvNoStat": string,
  "dpvNoStatReasonCode": integer,
  "dpvDrop": string,
  "dpvThrowback": string,
  "dpvNonDeliveryDays": string,
  "dpvNonDeliveryDaysValues": integer,
  "dpvNoSecureLocation": string,
  "dpvPbsa": string,
  "dpvDoorNotAccessible": string,
  "dpvEnhancedDeliveryCode": string,
  "carrierRoute": string,
  "carrierRouteIndicator": string,
  "ewsNoMatch": boolean,
  "postOfficeCity": string,
  "postOfficeState": string,
  "abbreviatedCity": string,
  "fipsCountyCode": string,
  "county": string,
  "elotNumber": string,
  "elotFlag": string,
  "lacsLinkReturnCode": string,
  "lacsLinkIndicator": string,
  "poBoxOnlyPostalCode": boolean,
  "suitelinkFootnote": string,
  "pmbDesignator": string,
  "pmbNumber": string,
  "addressRecordType": string,
  "defaultAddress": boolean,
  "errorMessage": string,
  "cassProcessed": boolean
}

object (UspsAddress)

USPS 標準の住所。

string

2 桁の配達ポイント コード

string

配達ポイントのチェック ディジット。この番号は、機械的にスキャンされたメールの場合、delivery_point_barcode の末尾に追加されます。Delivery_point_barcode、deliveryPointCheckDigit、郵便番号、ZIP+4 のすべての桁を加算すると、10 で割り切れる数値が得られます。

string

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

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

string

デリバリー ポイントの検証の脚注。1 つの文字列に複数の脚注をつなぎ合わせることができます。

• AA: ZIP+4 ファイルと一致する入力アドレス
• A1: 入力アドレスが ZIP+4 ファイルと一致しませんでした
• BB: DPV に一致（すべてのコンポーネント）
• CC: 予備の電話番号が一致せず、必須ではありません
• C1: 一致しないが必須となる予備の番号
• N1: 高層の住所に予備の番号がありません
• M1: メインの番号がありません
• M3: メインの番号が無効です
• P1: 入力住所の PO、RR、HC の箱番号がない
• P3: 入力された住所の PO、RR、または HC Box 番号が無効
• 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

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

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

integer

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

• 1: IDA（Internal Drop Address）– USPS から直接メールを受信しないが、サービスを提供するドロップ アドレスに配送されるアドレス。
• 2: CDS - まだ配達されていない住所です。たとえば、区画と 1 次番号は決定されているものの、占有率の構造がまだ存在しない新しい区分です。
• 3: 競合 - 実際には DPV で確認されていない住所です。
• 4: CMZ（College, Military and Other Types） - ZIP + 4 件のレコードが USPS によってデータに組み込まれています。
• 5: 標準 - 住所が配達されていないことを示します。また、その住所は配信候補としてカウントされません。
• 6: セカンダリ（必須） - このアドレスには予備の情報が必要です。

string

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

• Y: サイトの単一の受信可能先にメールが配信されます。
• N: メールはサイトの特定の受信先には配信されません。

string

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

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

string

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

• Y: メール配信は毎日行われません。
• N: メール配信が毎日行われていないことを示します。

integer

配送不能日数を識別する整数。ビットフラグを使用して照会できます。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 が確認されたのに、2 つ目の番号の情報が未確認で存在していたか、DPV を一致させて必要な情報を得るためにメインの番号の末尾のアルファが 1 つ抜けていました。
• D: 住所はメインの電話番号でのみ DPV が確認され、予備の電話番号の情報がありません。
• R: 住所が確認されましたが、ファントム ルート R777 と R779 に割り当てられ、USPS による配達が提供されていません。

string

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

接頭辞:

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

string

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

boolean

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

string

郵便局の主要都市。

string

主な郵便局の州。

string

都市の略称。

string

FIPS 郡コード。

string

郡名。

string

拡張旅行行程（eLOT）番号。

string

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

string

LACSLink の戻りコード。

string

LACSLink インジケーター。

boolean

私書箱のみの郵便番号。

string

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

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

string

PMB（私用メールボックス）のユニット指定子。

string

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

string

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

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

boolean

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

string

USPS データ取得に関するエラー メッセージ。この値は、人為的に作成された住所が検出されたために USPS の処理が一時停止された場合に入力されます。

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

boolean

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

{
  "firstAddressLine": string,
  "firm": string,
  "secondAddressLine": string,
  "urbanization": string,
  "cityStateZipAddressLine": string,
  "city": string,
  "state": string,
  "zipCode": string,
  "zipCodeExtension": string
}

string

住所 1 行目。

string

会社名。

string

住所の 2 行目。

string

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

string

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

string

市町村名。

string

2 文字の州コード。

string

郵便番号（例: 10009）。

string

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