Package google.maps.addressvalidation.v1

索引

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_addresspostal_addressaddress_components に存在しません。たとえば、「Boulder, Colorado, 80301, USA」のような入力の場合は、['street_number', 'route'] のようになります。使用可能なタイプの一覧については、こちらをご覧ください。

unconfirmed_component_types[]

string

address_components に存在するものの、正しいことを確認できなかったコンポーネントのタイプ。このフィールドは便宜上提供されています。その内容は、confirmation_levelCONFIRMED でないか、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)。

po_box_only_postal_code

bool

私書箱のみの郵便番号。

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 は、recipientsorganization の値を無視します。これらのフィールドの値は破棄され、返されません。設定しないでください。

previous_response_id

string

最初の住所検証リクエストでは、このフィールドを空にする必要があります。1 つの住所を完全に検証するためにさらにリクエストが必要な場合(たとえば、最初の検証後にユーザーが行った変更を再検証する必要がある場合)、フォローアップ リクエストでは、検証シーケンスの最初のレスポンスの response_id をこのフィールドに入力する必要があります。

enable_usps_cass

bool

USPS CASS 互換モードを有効にします。これは google.maps.addressvalidation.v1.ValidationResultgoogle.maps.addressvalidation.v1.ValidationResult.usps_data フィールドのみに影響します。注: プエルトリコの住所に対する USPS CASS 対応リクエストでは、addressgoogle.type.PostalAddress.region_code を「PR」として指定するか、addressgoogle.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 が提供する追加の配送フラグ。リージョン USPR でのみ提供されます。

english_latin_address

Address

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

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

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

注: english_latin_addressgoogle.maps.addressvalidation.v1.Address.unconfirmed_component_types フィールドと english_latin_address.address_componentsgoogle.maps.addressvalidation.v1.AddressComponent.confirmation_level フィールドには値が入力されません。

判断

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

フィールド
input_granularity

Granularity

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

たとえば、入力住所に特定のアパート番号が含まれている場合、ここでの input_granularitySUB_PREMISE になります。データベース内のアパート名が一致しない場合、またはアパート名が無効な場合、validation_granularityPREMISE 以下になる可能性が高くなります。

validation_granularity

Granularity

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

住所ごとのコンポーネントの検証結果は、google.maps.addressvalidation.v1.Address.address_components で確認できます。

geocode_granularity

Granularity

geocode の粒度に関する情報。これは、ジオコーディングされた位置情報がどの程度粗いか、または細かなセマンティックな意味であると理解できます。

これは上記の validation_granularity と異なる場合があります。たとえば、データベースにはアパート番号の存在が記録されていても、大きな集合住宅の正確な位置がわからない場合があります。この場合、validation_granularitySUB_PREMISE になりますが、geocode_granularityPREMISE になります。

address_complete

bool

未解決のトークンや想定外の住所要素、欠落している住所がなければ、住所は完全とみなされます。詳しくは、missing_component_typesunresolved_tokensunexpected フィールドをご覧ください。

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 その他のすべての粒度は、提供できないためまとめてバケットにまとめられます。