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	PostalAddress 郵送先住所として表される、後処理された住所。
address_components[]	AddressComponent 順序なしリスト。フォーマットおよび修正された住所の個々の住所コンポーネントと、検証情報。個々のコンポーネントの検証ステータスに関する情報を確認できます。 住所コンポーネントの順序が異なるわけではありません。リスト内の住所コンポーネントの順序を前提にしないでください。
missing_component_types[]	string 正しい形式の送付先住所に含まれているはずだったコンポーネントのタイプが、入力に含まれておらず、かつ推測できなかったもの。このタイプのコンポーネントは、formatted_address、postal_address、address_components に存在しません。たとえば、「Boulder, Colorado, 80301, USA」のような入力の場合は、['street_number', 'route'] のようになります。使用可能なタイプの一覧については、こちらをご覧ください。
unconfirmed_component_types[]	string address_components に存在するものの、正しいことを確認できなかったコンポーネントのタイプ。このフィールドは便宜上提供されています。その内容は、confirmation_level が CONFIRMED でないか、inferred フラグが true に設定されていないすべてのコンポーネントの型を検索する address_components の反復処理と同じです。使用可能なタイプの一覧については、こちらをご覧ください。
unresolved_tokens[]	string 解決できなかった入力内のトークン。これは、住所の有効な部分として認識されなかった入力である可能性があります（たとえば、「123235253253 Main St, San Francisco, CA, 94105」のような入力では、未解決のトークンは ["123235253253"] のようになります。有効な番地ではないからです。

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	Google は、この要素が存在し、住所の残りの部分のコンテキストで意味をなすことを確認しました。
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 ジオコーディングされた場所のサイズ（メートル単位）。これはジオコーディングされた場所の粗さを示すもう一つの尺度ですが、セマンティックな意味というよりも物理的なサイズで表します。
place_id	string この入力によってジオコーディングされる場所の PlaceID。 プレイス ID について詳しくは、こちらをご覧ください。
place_types[]	string 入力がジオコーディングされた場所のタイプ（複数可）。たとえば、['locality', 'political'].タイプの一覧については、こちらをご覧ください。

LanguageOptions

プレビュー: この機能はプレビュー版（pre-GA）です。一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、一般提供前のプロダクトや機能の変更は、他の一般提供前のバージョンと互換性がない場合があります。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 mx14 m（1/8,000 度）以下の長方形を定義するグローバル コードと、プレフィックスをリファレンスの場所に置き換える複合コードの 2 つの形式のロケーション参照です。

フィールド
global_code	string 場所のグローバル（完全）コード。たとえば「9FWM33GV+HQ」は、1/8, 000 x 1/8,000 度の領域（約 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 に送信されるすべての米国または PR の住所で 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、postal code、ZIP+4 のすべての桁を加算すると、10 で割り切れる数値になります。
dpv_confirmation	string DPV 確認に使用できる値。1 文字を返すか、値を返しません。 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: 入力された住所の PO、RR、HC の箱番号が無効です F1: 軍施設の住所と一致する入力住所 G1: 入力住所が一般的な配送先住所と一致しました U1: 一意の郵便番号に一致する入力住所 PB: PBSA レコードと一致する入力アドレス RR: PMB 情報を含む DPV 確認済み住所 R1: PMB 情報のない DPV 確認済み住所 R7: Carrier Route R777 または R779 のレコード IA: 通知先住所を特定しました TA: 末尾のアルファをドロップして照合されるメインの数値
dpv_cmra	string 住所が 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 のタイプを示します。理由コードを int として返します。 1: IDA（Internal Drop Address）– USPS から直接郵便物を受け取らないものの、それらにサービスを提供する送付先住所に配送されるアドレス。 2: CDS - まだ配達が完了していない住所。たとえば、区画やメインの番号は決まっているものの、利用人数の構造がまだ存在しない新しい区分などです。 3: 競合 - 実際に DPV で確認されていない住所。 4: CMZ（College、Military、Other Types）- ZIP + 4 レコード。USPS によりデータが取り込まれています。 5: 標準 - 住所が配信されていないことを表します。配信候補としてカウントされません。 6: 二次必須 - このアドレスには二次情報が必要です。
dpv_drop	string フラグは、サイトの単一の受信可能にメールが配信されることを示します。1 文字を返します。 Y: メールはサイトの単一の受信担当者に配信されます。 N: メールはサイトの単一の受信担当者に配信されません。
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 が確認され、セカンダリ番号の情報は確認されませんでした。または、DPV の一致とセカンダリ情報が必要なため、メインの番号の末尾の 1 つのアルファが破棄されました。 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 道路や高層ビルのレコードから部屋の情報にマッチした脚注。ビジネス名が一致する場合、予備の番号が返されます。 A: SuiteLink のレコード マッチング、ビジネス拠点の住所が改善されました。 00: 一致なし。ビジネスの住所は改善されません。
pmb_designator	string PMB（私用メールボックス）の単位指定子。
pmb_number	string PMB（私書箱）番号
address_record_type	string 入力住所に一致する住所レコードのタイプ。 F: 会社。これは、住所で利用できる最も詳細な一致レベルである企業レコードに一致します。 G: 一般的な配信。これは一般配達レコードと一致します。 H: 建物 / アパート。これは、ビルディングまたはアパートのレコードと一致しています。 P: オフィス ボックスのポスト。これは私書箱に一致します。 R: RURAL ROUTE または HIGHWAY CONTRACT: これは Rural Route または Highway Contract レコードに一致します。どちらも Box Number の範囲が関連付けられている可能性があります。 S: STREET RECORD: 有効なプライマリ数値範囲を含む Street レコードに一致します。
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 を「プエルトリコ」（大文字と小文字を区別しない）または「PR」として指定する必要があります。 コンポーネント化された address を使用するか、少なくとも 2 つの google.type.PostalAddress.address_lines を指定し、最初の行に番地と名前が含まれ、2 行目に都市、都道府県、郵便番号が含まれるようにすることをおすすめします。
language_options	LanguageOptions 省略可。プレビュー: この機能はプレビュー版（pre-GA）です。一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、一般提供前のプロダクトや機能の変更は、他の一般提供前のバージョンと互換性がない場合があります。pre-GA のサービスには、Google Maps Platform サービス固有の規約が適用されます。詳細については、リリース ステージの説明をご覧ください。 Address Validation API がレスポンスに追加情報を含めることを有効にします。
session_token	string 省略可。オートコンプリート セッションを課金目的で識別する文字列。長さが 36 文字以下の ASCII 文字の、URL とファイル名に安全な base64 文字列にする必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。 セッションは、ユーザーがオートコンプリート クエリを実行すると開始され、場所を選択して Place Details または Address Validation が呼び出されると終了します。各セッションでは、複数の Autocomplete クエリの後に 1 つの Place Details または Address Validation リクエストが続きます。セッション内の各リクエストに使用される認証情報は、同じ Google Cloud コンソール プロジェクトに属している必要があります。セッションが終了するとトークンは無効になります。アプリでセッションごとに新しいトークンを生成する必要があります。sessionToken パラメータを省略した場合、またはセッション トークンを再利用する場合は、セッション トークンを指定しなかった場合と同様にセッションが課金されます（各リクエストは個別に課金されます）。 注: Address Validation は Autocomplete (New) 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）です。一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、一般提供前のプロダクトや機能の変更は、他の一般提供前のバージョンと互換性がない場合があります。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 が住所を完全に検証できる粒度レベル。validateたとえば、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 入力に含まれていない住所コンポーネントが推定（追加）されました。詳しくは、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 を識別します。ただし、レッドウッド シティで「123 Main Street」のジオコードが見つからなかった場合、住所がより詳細であっても、返されるジオコーディングの粒度は LOCALITY である可能性があります。

列挙型
GRANULARITY_UNSPECIFIED	デフォルト値。この値は使用されません。
SUB_PREMISE	アパートなど、建物より下のレベルの検索結果。
PREMISE	建物レベルの検索結果。
PREMISE_PROXIMITY	住所の建物レベルの位置を推定するジオコード。
BLOCK	住所またはジオコードがブロックを表しています。ブロックレベルのアドレス指定があるリージョン（日本など）でのみ使用します。
ROUTE	ジオコードまたは住所が、道路、道路、高速道路など、経路を細かく制御している。
OTHER	その他のすべての粒度は、提供できないためまとめてバケットにまとめられます。