Package google.maps.addressvalidation.v1

インデックス

• AddressValidation（インターフェース）
• Address（メッセージ）
• AddressComponent（メッセージ）
• AddressComponent.ConfirmationLevel（列挙型）
• AddressMetadata（メッセージ）
• ComponentName（メッセージ）
• Geocode（メッセージ）
• LanguageOptions（メッセージ）
• PlusCode（メッセージ）
• ProvideValidationFeedbackRequest（メッセージ）
• ProvideValidationFeedbackRequest.ValidationConclusion（列挙型）
• ProvideValidationFeedbackResponse（メッセージ）
• UspsAddress（メッセージ）
• UspsData（メッセージ）
• ValidateAddressRequest（メッセージ）
• ValidateAddressResponse（メッセージ）
• ValidationResult（メッセージ）
• Verdict（メッセージ）
• Verdict.Granularity（列挙型）

AddressValidation

住所を検証するサービス。

ProvideValidationFeedback
rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse) 一連の検証試行の結果に関するフィードバック。これは、同じ住所に対する一連の検証呼び出しの後に行う最後の呼び出しであり、トランザクションが完了した後に呼び出す必要があります。これは、住所を完全に検証するために必要な ValidateAddress リクエストのシーケンスに対して 1 回だけ送信する必要があります。

ValidateAddress
rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse) 住所を検証します。

住所

処理後の住所の詳細。後処理には、住所のスペルミスの修正、誤った部分の置き換え、不足している部分の推定が含まれます。

フィールド
formatted_address	string 住所が存在する地域の住所形式ルールに従って、1 行の住所としてフォーマットされた、後処理済みの住所。 注: このアドレスの形式は、postal_address フィールドのアドレスの形式と一致しない場合があります。たとえば、postal_address は常に国を 2 文字の region_code（「US」や「NZ」など）として表します。一方、このフィールドでは、国名の長い形式（「米国」や「ニュージーランド」など）が使用されます。
postal_address	PostalAddress 住所として表された、後処理済みの住所。
address_components[]	AddressComponent 順序なしリスト。形式が整えられて修正された住所の個々の住所構成要素と、検証情報。これにより、個々のコンポーネントの検証ステータスに関する情報が提供されます。 住所コンポーネントは特定の順序で並べられていません。リスト内の住所の要素の順序を前提としない。
missing_component_types[]	string 正しい形式の郵送先住所に存在することが想定されるが、入力に見つからず、推測もできないコンポーネントのタイプ。たとえば、「Boulder, Colorado, 80301, USA」という入力に対して ['street_number', 'route'] という値を指定します。使用可能なタイプのリストについては、こちらをご覧ください。 注: 不足しているコンポーネントをすでに指定していると思われる場合でも、不足しているコンポーネントのタイプが表示されることがあります。たとえば、入力された住所に建物名は含まれていても、建物番号が含まれていない場合に、この問題が発生することがあります。住所「渋谷区渋谷３丁目　 Shibuya Stream」では、建物名「Shibuya Stream」のコンポーネント タイプは premise ですが、施設番号がないため、missing_component_types には premise が含まれます。
unconfirmed_component_types[]	string address_components に存在するコンポーネントのタイプ。正しいことを確認できなかったコンポーネントです。このフィールドは便宜上提供されています。その内容は、address_components を反復処理して、confirmation_level が CONFIRMED でないか、inferred フラグが true に設定されていないすべてのコンポーネントのタイプを見つけることに相当します。使用可能なタイプのリストについては、こちらをご覧ください。
unresolved_tokens[]	string 入力内の解決できなかったトークン。住所の有効な部分として認識されなかった入力である可能性があります。たとえば、「Parcel 0000123123 & 0000456456 Str # Guthrie Center IA 50115 US」という入力の場合、未解決のトークンは ["Parcel", "0000123123", "&", "0000456456"] のように表示されます。

AddressComponent

住所の構成要素（番地、市区町村、都道府県など）を表します。

フィールド
component_name	ComponentName このコンポーネントの名前。
component_type	string 住所コンポーネントのタイプ。使用可能なタイプのリストについては、表 2: プレイス サービスで返されるその他のタイプをご覧ください。
confirmation_level	ConfirmationLevel コンポーネントが正しいことの確信度を示します。
inferred	bool 入力に含まれていなかったが、住所の場所から推測されたコンポーネントであり、完全な住所として提供すべきであることを示します。
spell_corrected	bool コンポーネント名のスペルミスの修正を示します。API は、スペルのバリエーションの変更を常に報告するわけではありません（「centre」を「center」に変更した場合など）。また、「Amphitheater Pkwy」を「Amphitheatre Pkwy」に変更するなど、よくあるスペルミスが常に報告されるわけではありません。
replaced	bool コンポーネントの名前がまったく別のものに置き換えられたことを意味します。たとえば、間違った郵便番号が住所に対応する正しい郵便番号に置き換えられたなどです。これは外観の変更ではなく、入力コンポーネントが別のコンポーネントに変更されています。
unexpected	bool 指定された地域の郵便住所に存在しないことが想定される住所構成要素を示します。入力の一部であるためのみ保持しています。

ConfirmationLevel

確認レベルに指定できる値。

列挙型
CONFIRMATION_LEVEL_UNSPECIFIED	デフォルト値。この値は使用されません。
CONFIRMED	このコンポーネントが存在し、住所の他の部分のコンテキストで妥当であることを確認できました。
UNCONFIRMED_BUT_PLAUSIBLE	このコンポーネントは確認できませんでしたが、存在する可能性はあります。たとえば、特定の建物番号が不明な道路で、既知の有効な番号範囲内の番地などです。
UNCONFIRMED_AND_SUSPICIOUS	このコンポーネントは確認されていないため、誤っている可能性があります。たとえば、住所の残りの部分と一致しない地域などです。

AddressMetadata

後処理済みの住所のメタデータ。Address Validation API に送信されるすべての住所について、metadata が完全に入力される保証はありません。

フィールド
business	bool ビジネスの住所であることを示します。未設定の場合、値は不明であることを示します。
po_box	bool 私書箱の住所であることを示します。未設定の場合、値は不明であることを示します。
residential	bool 住所であることを示します。未設定の場合、値は不明であることを示します。

ComponentName

コンポーネント名のラッパー。

フィールド
text	string 名前のテキスト。たとえば、通り名の場合は「5th Avenue」、番地の場合は「1253」と入力します。
language_code	string BCP-47 言語コード。コンポーネント名が言語に関連付けられていない場合（番地など）は、このフィールドは表示されません。

ジオコード

入力がジオコーディングされた場所に関する情報が含まれます。

フィールド
location	LatLng 入力のジオコーディングされた位置情報。 住所、緯度/経度の座標、Plus Code を使用するよりも、プレイス ID を使用することをおすすめします。ルート検索やルート案内で座標を使用すると、その座標に最も近い道路にポイントがスナップされます。目的地に迅速かつ安全に到達できる道路ではない可能性があります。また、物件へのアクセス ポイントの近くにないこともあります。また、位置情報をリバース ジオコーディングしても、返された住所が元の住所と一致するとは限りません。
plus_code	PlusCode location に対応する Plus Code。
bounds	Viewport ジオコーディングされた場所の境界。
feature_size_meters	float ジオコーディングされた場所のサイズ（メートル単位）。これは、ジオコーディングされた位置情報の粗さを表すもう 1 つの指標ですが、意味的な意味ではなく物理的なサイズで表されます。
place_id	string この入力がジオコーディングされた場所の PlaceID。 Place ID について詳しくは、こちらをご覧ください。
place_types[]	string 入力がジオコーディングされた場所のタイプ。たとえば、['locality', 'political'].タイプの一覧については、こちらをご覧ください。

LanguageOptions

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

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

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

PlusCode

Plus Code（http://plus.codes）は、14 m x 14 m（8000 分の 1）以下の長方形を定義するグローバル コードと、プレフィックスを参照地に置き換えた複合コードの 2 つの形式で表される場所の参照情報です。

フィールド
global_code	string 場所のグローバル（完全）コード（「9FWM33GV+HQ」など）。8000 分の 1 x 8000 分の 1 度（約 14 メートル x 14 メートル）のエリアを表します。
compound_code	string 場所の複合コード（「33GV+HQ, Ramberg, Norway」など）。グローバル コードの接尾辞が含まれ、接頭辞は参照エンティティの形式付きの名前に置き換えられています。

ProvideValidationFeedbackRequest

検証フィードバックの送信リクエスト。

フィールド
conclusion	ValidationConclusion 必須。一連の検証試行の結果。 このフィールドが VALIDATION_CONCLUSION_UNSPECIFIED に設定されている場合、INVALID_ARGUMENT エラーが返されます。
response_id	string 必須。このフィードバックが対象の回答の ID。これは、一連のアドレス検証の最初のレスポンスの [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] である必要があります。

ValidationConclusion

住所の確認に必要な一連の住所確認リクエストの最終的な結果。

列挙型
VALIDATION_CONCLUSION_UNSPECIFIED	この値は使用されません。ProvideValidationFeedbackRequest.conclusion フィールドが VALIDATION_CONCLUSION_UNSPECIFIED に設定されている場合、INVALID_ARGUMENT エラーが返されます。
VALIDATED_VERSION_USED	取引に使用されたアドレスのバージョンは、Address Validation API から返されたものです。
USER_VERSION_USED	取引に使用された住所のバージョンがユーザーから提供されたものである
UNVALIDATED_VERSION_USED	最後の検証の試行後に入力されたが、再検証されていないアドレスのバージョンが取引に使用されました。
UNUSED	取引が放棄され、住所は使用されませんでした。

ProvideValidationFeedbackResponse

この型にはフィールドがありません。

検証フィードバックに対するレスポンス。

フィードバックが正常に送信された場合、レスポンスは空になります。

UspsAddress

米国の住所の USPS 表現。

フィールド
first_address_line	string 住所の 1 行目。
firm	string 会社名。
second_address_line	string 住所の 2 行目。
urbanization	string プエルトリコの都市名。
city_state_zip_address_line	string 市区群 + 都道府県 + 郵便番号
city	string 市町村名。
state	string 2 文字の州コード。
zip_code	string 郵便番号（例: 10009）。
zip_code_extension	string 4 桁の郵便番号の拡張（例: 5023）。

UspsData

住所の USPS データ。Address Validation API に送信される米国またはプエルトリコの住所について、uspsData が完全に入力される保証はありません。uspsData をレスポンスの主な部分として使用する場合は、レスポンスにバックアップ アドレス フィールドを統合することをおすすめします。

フィールド
standardized_address	UspsAddress USPS の標準化された住所。
delivery_point_code	string 2 桁の配送所コード
delivery_point_check_digit	string 配送ポイントのチェック ディジット。この番号は、機械的にスキャンされた郵便物の delivery_point_barcode の末尾に追加されます。delivery_point_barcode、delivery_point_check_digit、郵便番号、ZIP+4 のすべての桁を足すと、10 で割り切れる数になります。
dpv_confirmation	string DPV 確認の有効な値。単一の文字を返すか、値を返しません。 N: プライマリ番号とセカンダリ番号の情報が DPV で確認されませんでした。 D: 住所がプライマリ番号のみで DPV で確認され、セカンダリ番号の情報が不足しています。 S: 住所はプライマリ番号のみ DPV で確認済みであり、セカンダリ番号の情報は存在するものの確認されていません。 Y: プライマリ番号とセカンダリ番号の住所が DPV で確認済み。 空: レスポンスに dpv_confirmation 値が含まれていない場合、住所は DPV 確認のために送信されていません。
dpv_footnote	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: 末尾のアルファベットを削除して一致したプライマリ番号
dpv_cmra	string 住所が CMRA（商業郵便受取業者）であるかどうかを示します。CMRA とは、クライアントの郵便物を受け取る民間企業です。1 文字を返します。 Y: アドレスが CMRA である N: アドレスが CMRA ではない
dpv_vacant	string この場所は空いていますか？1 文字を返します。 Y: 住所が空き家である N: 住所が空き家ではない
dpv_no_stat	string 統計情報のない住所ですか？それとも有効な住所ですか？統計アドレスは、継続的に居住していないアドレスや、USPS がサービスを提供していないアドレスではありません。1 文字を返します。 Y: アドレスがアクティブではありません N: アドレスが有効
dpv_no_stat_reason_code	int32 NoStat タイプを示します。理由コードを整数として返します。 1: IDA（内部配送先住所）- USPS から直接郵便物が届くのではなく、配送先住所として指定されている住所。 2: CDS - まだ配達できない住所。たとえば、区画とプライマリ番号が決定されているが、居住可能な建物がまだ存在しない新しい分譲地などです。 3: 競合 - 実際に DPV 確認が行われないアドレス。 4: CMZ（大学、軍隊、その他の種類）- USPS がデータに組み込んだ ZIP + 4 レコード。 5: 通常 - 配送が行われていない住所を示します。これらの住所は配送の対象としてカウントされません。 6: セカンダリ必須 - アドレスにセカンダリ情報が必要です。
dpv_drop	string 1 つのサイト内の 1 つの受信トレイに郵便物が配達されることを示すフラグ。1 文字を返します。 Y: 郵便物は、サイト内の 1 つの受信トレイに配達されます。 N: 郵便物は、サイト内の 1 つの受信トレイに配達されません。
dpv_throwback	string 郵便物が住所に発送されないことを示します。1 文字を返します。 Y: 郵便物が番地に配達されない。 N: 郵便物は番地に配達されます。
dpv_non_delivery_days	string 郵便配達が毎日行われないことを示すフラグ。1 文字を返します。 Y: 郵便配達は毎日行われるわけではありません。 N: 郵便配達が毎日行われていないことを示す記号はありません。
dpv_non_delivery_days_values	int32 配達が行われない日を識別する整数。ビットフラグを使用して照会できます。0x40 - 日曜日は配達日ではない 0x20 - 月曜日は配達日ではない 0x10 - 火曜日は配達日ではない 0x08 - 水曜日は配達日ではない 0x04 - 木曜日は配達日ではない 0x02 - 金曜日は配達日ではない 0x01 - 土曜日は配達日ではない
dpv_no_secure_location	string ドアは開くことができるが、セキュリティ上の懸念から荷物は置かれないことを示すフラグ。1 文字を返します。 Y: セキュリティ上の懸念から、パッケージは残されません。 N: セキュリティ上の懸念からパッケージが残されないことを示す兆候はありません。
dpv_pbsa	string 住所が PBSA レコードと一致したことを示します。1 文字を返します。 Y: 住所が PBSA レコードと一致しました。 N: 住所が PBSA レコードと一致しませんでした。
dpv_door_not_accessible	string USPS がドアをノックして郵便物を配達できない住所を示すフラグ。1 文字を返します。 Y: ドアにはアクセスできません。 N: ドアが開かないことを示す表示はありません。
dpv_enhanced_delivery_code	string 住所に対して複数の DPV 戻りコードが有効であることを示します。1 文字を返します。 Y: プライマリ番号とセカンダリ番号の住所が DPV で確認済み。 N: プライマリ番号とセカンダリ番号の情報が DPV で確認されませんでした。 S: 住所がプライマリ番号でのみ DPV で確認され、セカンダリ番号の情報は存在するものの確認されていないか、プライマリ番号の末尾のアルファベットが 1 つ削除されて DPV が一致し、セカンダリ情報が必須になっている。 D: 住所がプライマリ番号のみで DPV で確認され、セカンダリ番号の情報が不足しています。 R: 住所は確認されているが、ファントム ルート R777 と R779 に割り当てられており、USPS 配達は提供されていない。
carrier_route	string 運送業者のルートコード。1 文字の接頭辞と 3 桁のルート記号で構成される 4 文字のコード。 接頭辞: C: 運送業者のルート（または市内ルート） R: 農村ルート H: 高速道路契約ルート B: 郵便私書箱セクション G: 一般配送ユニット
carrier_route_indicator	string 運送会社のルート料金の並べ替えインジケーター。
ews_no_match	bool 配送先住所は一致しますが、EWS ファイルには、完全一致がまもなく利用可能になると示されています。
post_office_city	string メインの郵便局がある都市。
post_office_state	string メインの郵便局の状態。
abbreviated_city	string 都市の省略形。
fips_county_code	string FIPS 郡コード。
county	string 郡名。
elot_number	string 拡張ルート（eLOT）番号。
elot_flag	string eLOT 昇順/降順フラグ（A/D）。
lacs_link_return_code	string LACSLink の戻りコード。
lacs_link_indicator	string LACSLink インジケーター。
po_box_only_postal_code	bool 郵便ポストボックスのみの郵便番号。
suitelink_footnote	string ストリートまたは高層ビルのレコードとスイート情報の照合による脚注。ビジネス名が一致すると、2 番目の電話番号が返されます。 A: SuiteLink レコードが一致し、ビジネス拠点の住所が改善されました。 00: 一致なし。ビジネス拠点の住所は改善されていません。
pmb_designator	string PMB（私書箱）ユニットの指定子。
pmb_number	string PMB（私書箱）番号
address_record_type	string 入力アドレスに一致する住所レコードのタイプ。 F: FIRM。これは、住所に対して利用可能な最も細かいレベルの一致である、企業レコードとの一致です。 G: 一般配送。これは、一般配達レコードと一致しています。 H: 建物 / アパート。これは、建物またはアパートのレコードと一致しています。 P: 郵便私書箱。これは私書箱に一致しています。 R: RURAL ROUTE または HIGHWAY CONTRACT: これは、Rural Route レコードまたは Highway Contract レコードのいずれかに一致します。どちらにも、関連付けられたボックス番号の範囲が設定されている場合があります。 S: ストリート レコード: 有効なプライマリ番号範囲を含むストリート レコードと一致します。
default_address	bool デフォルトの住所が見つかったものの、より具体的な住所が存在することを示すインジケーター。
error_message	string USPS データの取得に関するエラー メッセージ。人為的に作成された住所が検出されたために USPS の処理が停止された場合に入力されます。 このエラーが発生すると、USPS データ フィールドにデータが入力されないことがあります。
cass_processed	bool リクエストが CASS で処理されたことを示すインジケーター。

ValidateAddressRequest

住所の確認リクエスト。

フィールド
address	PostalAddress 必須。住所の確認中。フォーマットされていない住所は address_lines 経由で送信する必要があります。 この入力のフィールドの合計長は 280 文字以内にする必要があります。 サポートされている地域については、こちらをご覧ください。 入力アドレスの language_code 値は将来の使用のために予約されており、現時点では無視されます。検証済みの住所の結果は、システムによって特定された、その住所の優先言語に基づいて入力されます。 Address Validation API は、recipients と organization の値を無視します。これらのフィールドの値は破棄され、返されません。設定しないでください。
previous_response_id	string 最初の住所確認リクエストでは、このフィールドを空にする必要があります。1 つの住所を完全に検証するためにさらにリクエストが必要な場合（たとえば、ユーザーが最初の検証後に行った変更を再検証する必要がある場合など）、各フォローアップ リクエストで、検証シーケンスの最初のレスポンスの response_id をこのフィールドに入力する必要があります。
enable_usps_cass	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 番目の行に市区町村、都道府県、郵便番号を指定します。
language_options	LanguageOptions 省略可。プレビュー版: この機能はプレビュー版（一般提供前）です。一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、一般提供前のプロダクトや機能の変更は、他の一般提供前のバージョンと互換性がない場合があります。pre-GA のサービスには、Google Maps Platform サービス固有の規約が適用されます。詳細については、リリース ステージの説明をご覧ください。 Address Validation API がレスポンスに追加情報を含めることができるようにします。
session_token	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 をご覧ください。

ValidateAddressResponse

住所確認リクエストに対するレスポンス。

フィールド
result	ValidationResult 住所確認の結果。
response_id	string このレスポンスを識別する UUID。住所の再確認が必要な場合は、この UUID を新しいリクエストに添付する必要があります。

ValidationResult

住所の検証結果。

フィールド
verdict	Verdict 全体的な判定結果のフラグ
address	Address ジオコードではなく、住所自体に関する情報。
geocode	Geocode 住所がジオコーディングされた場所と場所に関する情報。
metadata	AddressMetadata 配信に関連するその他の情報。Address Validation API に送信されるすべての住所について、metadata が完全に入力される保証はありません。
usps_data	UspsData USPS が提供する追加の配送可否フラグ。リージョン US と PR でのみ指定されます。
english_latin_address	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 フィールドには値が入力されません。

判定

住所の検証結果とジオコードの概要。

フィールド
input_granularity	Granularity 入力アドレスの粒度。これは入力アドレスの解析結果であり、検証シグナルは提供されません。検証シグナルについては、下記の validation_granularity をご覧ください。 たとえば、入力アドレスに特定の部屋番号が含まれている場合、ここでの input_granularity は SUB_PREMISE になります。データベース内の部屋番号と一致しないか、部屋番号が無効な場合、validation_granularity は PREMISE またはそれより粗い値になる可能性があります。
validation_granularity	Granularity API が完全に検証できる、処理後の住所の詳細レベル。たとえば、validation_granularity が PREMISE の場合、PREMISE 以上のレベルのすべての住所コンポーネントを検証できます。 住所の構成要素ごとの検証結果は google.maps.addressvalidation.v1.Address.address_components にあります。
geocode_granularity	Granularity geocode の粒度に関する情報。これは、ジオコーディングされた位置の精度を意味します。 これは、上記の validation_granularity とは異なる場合があります。たとえば、データベースにはアパートの番号が記録されているものの、大きなアパート団地内のアパートの正確な位置が記録されていない場合があります。この場合、validation_granularity は SUB_PREMISE ですが、geocode_granularity は PREMISE になります。
address_complete	bool 未解決のトークンがなく、住所の要素が予期せず欠落していない場合、後処理された住所は完全と見なされます。未設定の場合、値は false です。詳細については、missing_component_types、unresolved_tokens、unexpected フィールドをご覧ください。
has_unconfirmed_components	bool 住所のコンポーネントのうち少なくとも 1 つを分類または検証できません。詳細については、google.maps.addressvalidation.v1.Address.address_components をご覧ください。
has_inferred_components	bool 入力に含まれていない住所の要素が少なくとも 1 つ推論（追加）されました。詳しくは google.maps.addressvalidation.v1.Address.address_components をご覧ください。
has_replaced_components	bool 住所のコンポーネントが 1 つ以上置き換えられました。詳細については、google.maps.addressvalidation.v1.Address.address_components をご覧ください。

粒度

住所またはジオコードに設定できるさまざまな粒度。住所の粒度を示すために使用する場合、これらの値は、住所が郵送先を識別する粒度を示します。たとえば、「123 Main Street, Redwood City, CA, 94061」という住所は PREMISE を表し、「Redwood City, CA, 94061」という住所は LOCALITY を表します。ただし、Redwood City の「123 Main Street」のジオコードが見つからない場合は、住所の精度がそれよりも高いにもかかわらず、返されるジオコードの精度は LOCALITY になることがあります。

列挙型
GRANULARITY_UNSPECIFIED	デフォルト値。この値は使用されません。
SUB_PREMISE	建物単位より下の結果（アパートなど）。
PREMISE	建物レベルの結果。
PREMISE_PROXIMITY	住所の建物レベルの位置を近似したジオコード。
BLOCK	住所またはジオコードはブロックを示します。ブロックレベルのアドレス指定が使用されている地域（日本など）でのみ使用されます。
ROUTE	ジオコードまたは住所が道路、道路、高速道路などのルート単位で指定されている。
OTHER	その他のすべての粒度。配信できないため、まとめてバケット化されます。