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	この要素が存在し、住所の残りの部分のコンテキストで意味をなしていることを検証できました。
UNCONFIRMED_BUT_PLAUSIBLE	このコンポーネントを確認できませんでしたが、存在する可能性が高いです。例: 特定の番地が不明な道路上で、既知の有効な範囲内の番地。
UNCONFIRMED_AND_SUSPICIOUS	このコンポーネントは確認されておらず、間違っている可能性があります。たとえば、残りの住所に当てはまらない近隣地域などです。

AddressMetadata

アドレスのメタデータ。metadata は、Address Validation API に送信されるすべての住所に対して完全に入力されるとは限りません。

フィールド
business	bool ビジネスの住所であることを示します。設定されていない場合、値が不明であることを示します。
po_box	bool 私書箱の住所を示します。設定されていない場合、値が不明であることを示します。
residential	bool 居住地の住所であることを示します。設定されていない場合、値が不明であることを示します。

ComponentName

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

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

ジオコード

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

フィールド
location	LatLng 入力のジオコーディングされた場所。 プレイス ID は、住所、緯度と経度の座標、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/8000 分の 1）以下の長方形を定義するグローバル コードと、プレフィックスを基準位置に置き換える複合コードという 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 データ。uspsData は、Address Validation API に送信されるすべての米国またはプエルトリコの住所に対して完全な住所が入力されるとは限りません。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: 予備の電話番号が一致せず、必須ではない 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: 末尾のアルファをドロップすることで一致したメインの番号
dpv_cmra	string 住所が CMRA（Commercial Mail Received Agency）（顧客の郵便物を受け取る民間企業）であるかどうかを示します。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（大学、軍事、その他のタイプ）- USPS がデータに組み込んだ ZIP + 4 レコード。 5: Regular - 配信を受信していないアドレスであり、そのアドレスは配信の可能性があるものとしてカウントされないことを示します。 6: 二次必須 - この住所には二次情報が必要です。
dpv_drop	string フラグは、メールがサイト上の 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 – 金曜日は未配送日 0x02 – 金曜日は未配送日 0x1
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（Private Mail Box）ユニット指定子。
pmb_number	string PMB（個人用メールボックス）番号
address_record_type	string 入力アドレスに一致するアドレス レコードのタイプ。 F: FIRM。これは、住所に使用できる最高レベルの一致である Firm Record との一致です。 G: 一般的な配信。これは一般配信レコードと一致します。 H: 建物 / マンション。これはビルディングまたはアパートの記録と一致しています。 P: オフィス用ボックス。これは私書箱と一致します。 R: RURAL ROUTE or HIGHWAY CONTRACT: Rural Route または Highway Contract のいずれかの記録に一致します。どちらにもボックス番号の範囲が関連付けられている可能性があります。 S: STREET RECORD: 有効なメインの数値範囲を含むストリート レコードと一致します。
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 を指定して、1 行目に番地と名前、2 行目に市区町村、都道府県、郵便番号を含めることをおすすめします。
language_options	LanguageOptions 省略可。プレビュー: この機能は、pre-GA（一般提供前）のプレビュー版です。一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、一般提供前のプロダクトや機能の変更は、他の一般提供前のバージョンと互換性がない場合があります。pre-GA のサービスには、Google Maps Platform サービス固有の規約が適用されます。詳細については、リリース ステージの説明をご覧ください。 レスポンスに追加の情報を含めるために Address Validation API を有効にします。
session_token	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 をご覧ください。

ValidateAddressResponse

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

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

ValidationResult

住所の検証結果。

フィールド
verdict	Verdict 総合判定フラグ
address	Address ジオコードではなく、住所自体に関する情報。
geocode	Geocode 住所がジオコーディングされた場所と場所に関する情報。
metadata	AddressMetadata 成果物に関するその他の情報。metadata は、Address Validation API に送信されるすべての住所に対して完全に入力されるとは限りません。
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 入力に含まれていない 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 を識別します。ただし、レッドウッド シティーの「123 Main Street」のジオコードが見つからない場合、返されるジオコードの精度は LOCALITY である可能性がありますが、住所はより細かです。

列挙型
GRANULARITY_UNSPECIFIED	デフォルト値。この値は使用されません。
SUB_PREMISE	アパートなどの建物より下の階の検索結果。
PREMISE	建物レベルの結果。
PREMISE_PROXIMITY	建物レベルの住所を推定するジオコード。
BLOCK	住所またはジオコードがブロックを示している。日本など、ブロックレベルのアドレス指定があるリージョンでのみ使用されます。
ROUTE	道路、道路、高速道路など、ルートのジオコードや住所が細分化されている。
OTHER	その他すべての粒度は、配信できないため一緒にバケット化されます。