索引
AddressValidation
(インターフェース)Address
(メッセージ)AddressComponent
(メッセージ)AddressComponent.ConfirmationLevel
(列挙型)AddressMetadata
(メッセージ)ComponentName
(メッセージ)Geocode
(メッセージ)LanguageOptions
(メッセージ)PlusCode
(メッセージ)ProvideValidationFeedbackRequest
(メッセージ)ProvideValidationFeedbackRequest.ValidationConclusion
(列挙型)ProvideValidationFeedbackResponse
(メッセージ)UspsAddress
(メッセージ)UspsData
(メッセージ)ValidateAddressRequest
(メッセージ)ValidateAddressResponse
(メッセージ)ValidationResult
(メッセージ)Verdict
(メッセージ)Verdict.Granularity
(列挙型)
AddressValidation
住所を検証するためのサービス。
ProvideValidationFeedback |
---|
一連の検証試行の結果に関するフィードバック。これは、同じ住所に対する一連の検証呼び出しの後に行われる最後の呼び出しで、トランザクションの完了後に呼び出す必要があります。これは、住所を完全に検証するために必要な一連の |
ValidateAddress |
---|
住所を検証します。 |
住所
後処理された住所の詳細。後処理には、住所のスペルミスのある箇所の修正、間違った箇所の置き換え、欠落している箇所の推測などが含まれます。
フィールド | |
---|---|
formatted_address |
後処理された住所。住所がある地域の住所形式ルールに従って、1 行で表記されます。 |
postal_address |
郵送先住所として表される、後処理された住所。 |
address_components[] |
順序なしリスト。フォーマットおよび修正された住所の個々の住所コンポーネントと、検証情報。個々のコンポーネントの検証ステータスに関する情報を確認できます。 住所コンポーネントの順序が異なるわけではありません。リスト内の住所コンポーネントの順序を前提にしないでください。 |
missing_component_types[] |
正しい形式の送付先住所に含まれているはずだったコンポーネントのタイプが、入力に含まれておらず、かつ推測できなかったもの。このタイプのコンポーネントは、 |
unconfirmed_component_types[] |
|
unresolved_tokens[] |
解決できなかった入力内のトークン。これは、住所の有効な部分として認識されなかった入力である可能性があります(たとえば、「123235253253 Main St, San Francisco, CA, 94105」のような入力では、未解決のトークンは |
AddressComponent
番地、市区町村、都道府県などの住所コンポーネントを表します。
フィールド | |
---|---|
component_name |
このコンポーネントの名前。 |
component_type |
住所コンポーネントのタイプ。指定可能なタイプのリストについては、表 2: プレイス サービスで返されるその他のタイプをご覧ください。 |
confirmation_level |
コンポーネントが正しいことに関する確実性のレベルを示します。 |
inferred |
コンポーネントは入力に含まれていませんが、住所の場所として推定され、完全な住所に対して提供されるべきだと判断されたことを示します。 |
spell_corrected |
コンポーネント名のスペルミスが修正されたことを示します。API は、「centre」を「center」に変更するなどして、あるスペルのバリアントから別のスペルに変更された場合に必ず報告するわけではありません。また、「Amphitheater Pkwy」を「Amphitheatre Pkwy」に変更するなど、一般的なスペルミスが報告されない場合もあります。 |
replaced |
コンポーネントの名前がまったく別の名前に置き換えられたことを示します。たとえば、間違った郵便番号が住所に対して正しい名前に置き換えられた場合などです。これは外観上の変更ではなく、入力コンポーネントが別のコンポーネントに変更されました。 |
unexpected |
指定された地域の郵便の宛先には含まれないはずの住所コンポーネントを示します。これは、入力の一部であったという理由だけで保持しています。 |
ConfirmationLevel
確認レベルのさまざまな値。
列挙型 | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED |
デフォルト値。この値は使用されません。 |
CONFIRMED |
Google は、この要素が存在し、住所の残りの部分のコンテキストで意味をなすことを確認しました。 |
UNCONFIRMED_BUT_PLAUSIBLE |
このコンポーネントは確認できませんでしたが、存在している可能性があります。たとえば、番地が不明な、道路上の有効な番号範囲の番地など。 |
UNCONFIRMED_AND_SUSPICIOUS |
このコンポーネントは確認されていないため、間違っている可能性があります。(例: 住所の残りの部分に一致しない地区)。 |
AddressMetadata
住所のメタデータ。Address Validation API に送信されるすべての住所に対して、metadata
が完全に入力されるとは限りません。
フィールド | |
---|---|
business |
ビジネスの住所であることを示します。設定されていない場合は、値が不明であることを示します。 |
po_box |
私書箱の住所を示します。設定されていない場合は、値が不明であることを示します。 |
residential |
居住地の住所であることを示します。設定されていない場合は、値が不明であることを示します。 |
ComponentName
コンポーネント名のラッパー。
フィールド | |
---|---|
text |
名前のテキスト。たとえば、道路名の場合は「5th Avenue」、番地の場合は「1253」です。 |
language_code |
BCP-47 言語コード。コンポーネント名が言語(番地など)に関連付けられていない場合、この属性は存在しません。 |
ジオコード
入力がジオコーディングされた場所に関する情報が含まれます。
フィールド | |
---|---|
location |
入力のジオコーディングされた場所。 住所、緯度と経度の座標、Plus Code よりもプレイス ID の使用をおすすめします。ルート選択や運転ルートの計算で座標を使用すると、ポイントは常にその座標に最も近い道路にスナップされます。目的地に迅速かつ安全につながる道路ではないこと、宿泊施設への出入り口付近でないことも考えられます。また、ビジネス情報をリバース ジオコーディングする場合、返される住所が元の住所と一致する保証はありません。 |
plus_code |
|
bounds |
ジオコーディングされた場所の境界。 |
feature_size_meters |
ジオコーディングされた場所のサイズ(メートル単位)。これはジオコーディングされた場所の粗さを示すもう一つの尺度ですが、セマンティックな意味というよりも物理的なサイズで表します。 |
place_id |
この入力によってジオコーディングされる場所の PlaceID。 プレイス ID について詳しくは、こちらをご覧ください。 |
place_types[] |
入力がジオコーディングされた場所のタイプ(複数可)。たとえば、 |
LanguageOptions
プレビュー: この機能はプレビュー版(pre-GA)です。一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、一般提供前のプロダクトや機能の変更は、他の一般提供前のバージョンと互換性がない場合があります。pre-GA のサービスには、Google Maps Platform サービス固有の規約が適用されます。詳細については、リリース ステージの説明をご覧ください。
Address Validation API がレスポンスに追加情報を含めることを有効にします。
フィールド | |
---|---|
return_english_latin_address |
プレビュー: 英語の |
PlusCode
Plus Code(http://plus.codes)は、14 mx14 m(1/8,000 度)以下の長方形を定義するグローバル コードと、プレフィックスをリファレンスの場所に置き換える複合コードの 2 つの形式のロケーション参照です。
フィールド | |
---|---|
global_code |
場所のグローバル(完全)コード。たとえば「9FWM33GV+HQ」は、1/8, 000 x 1/8,000 度の領域(約 14 x 14 メートル)を表します。 |
compound_code |
場所の複合コードで、「33GV+HQ, Ramberg, Norway」など。グローバル コードの接尾辞を含み、接頭辞は参照エンティティのフォーマットされた名前に置き換えます。 |
ProvideValidationFeedbackRequest
検証フィードバックを送信するためのリクエスト。
フィールド | |
---|---|
conclusion |
必須。一連の検証試行の結果。 このフィールドが |
response_id |
必須。このフィードバックの対象となる回答の 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 |
住所 1 行目。 |
firm |
企業名 |
second_address_line |
住所の 2 行目。 |
urbanization |
プエルトリコの都市化の名前。 |
city_state_zip_address_line |
市区町村 + 都道府県 + 郵便番号。 |
city |
市町村名。 |
state |
2 文字の州コード。 |
zip_code |
郵便番号(例: 10009)。 |
zip_code_extension |
4 桁の郵便番号の拡張コード(例: 5023)。 |
UspsData
住所の USPS データ。Address Validation API に送信されるすべての米国または PR の住所で uspsData
が完全に入力されるとは限りません。レスポンスのメインの部分として uspsData を使用する場合は、バックアップ アドレス フィールドをレスポンスに統合することをおすすめします。
フィールド | |
---|---|
standardized_address |
USPS 標準住所。 |
delivery_point_code |
2 桁の配送先コード |
delivery_point_check_digit |
配送先のチェック ディジット。機械的にスキャンされたメールの場合は、この番号が delivery_point_barcode の末尾に追加されます。Delivery_point_barcode、delivery_point_check_digit、postal code、ZIP+4 のすべての桁を加算すると、10 で割り切れる数値になります。 |
dpv_confirmation |
DPV 確認に使用できる値。1 文字を返すか、値を返しません。
|
dpv_footnote |
配送ポイントの検証の脚注複数の脚注を同じ文字列にまとめることができます。
|
dpv_cmra |
住所が CMRA(商業郵便受取所)かどうか、つまり顧客の郵便物を受け取る民間企業かどうかを示します。1 文字を返します。
|
dpv_vacant |
空いている場所ですか?1 文字を返します。
|
dpv_no_stat |
これは統計データのない住所ですか、それとも有効な住所ですか?統計情報がない住所とは、継続的に占有されていない住所や、USPS がサービスを提供していない住所です。1 文字を返します。
|
dpv_no_stat_reason_code |
NoStat のタイプを示します。理由コードを int として返します。
|
dpv_drop |
フラグは、サイトの単一の受信可能にメールが配信されることを示します。1 文字を返します。
|
dpv_throwback |
郵便物が番地に配送されないことを示します。1 文字を返します。
|
dpv_non_delivery_days |
メールの配信が毎日行われていないことを示すフラグ。1 文字を返します。
|
dpv_non_delivery_days_values |
配達不能の日数を識別する整数。次のビットフラグを使用して照会できます。0x40 – 日曜日が配達不能の日 0x20 – 月曜日が配達不能の日 0x10 – 火曜日が配達不能の日 0x08 – 水曜日が配達不能の日 0x04 – 木曜日が配達不能の日 0x02 – 金曜日が配達不能 – 土曜日が配達不能の日 0x01 |
dpv_no_secure_location |
フラグはドアにアクセス可能であるが、セキュリティ上の懸念により荷物が置かれないことを示しています。1 文字を返します。
|
dpv_pbsa |
アドレスが PBSA レコードと一致したことを示します。1 文字を返します。
|
dpv_door_not_accessible |
フラグは、USPS がドアをノックして郵便物を配送できない住所を示します。1 文字を返します。
|
dpv_enhanced_delivery_code |
このアドレスに対して複数の DPV 戻りコードが有効になっていることを示します。1 文字を返します。
|
carrier_route |
運送業者のルートコード。1 文字の接頭辞と 3 桁の経路指定子からなる 4 文字のコード。 接頭辞:
|
carrier_route_indicator |
運送業者のルートの送料の並べ替えインジケーター。 |
ews_no_match |
配送先住所は照合可能ですが、EWS ファイルには完全一致がまもなく利用可能になる旨が記載されています。 |
post_office_city |
主な郵便局の市区町村。 |
post_office_state |
メインの郵便局の州。 |
abbreviated_city |
略称の都市。 |
fips_county_code |
FIPS 郡コード。 |
county |
郡名。 |
elot_number |
拡張旅程(eLOT)番号。 |
elot_flag |
eLOT 昇順/降順フラグ(A/D)。 |
lacs_link_return_code |
LACSLink 戻りコード。 |
lacs_link_indicator |
LACSLink インジケーター。 |
po_box_only_postal_code |
私書箱のみの郵便番号。 |
suitelink_footnote |
道路や高層ビルのレコードから部屋の情報にマッチした脚注。ビジネス名が一致する場合、予備の番号が返されます。
|
pmb_designator |
PMB(私用メールボックス)の単位指定子。 |
pmb_number |
PMB(私書箱)番号 |
address_record_type |
入力住所に一致する住所レコードのタイプ。
|
default_address |
デフォルトの住所が見つかったものの、より具体的な住所が存在することを示すインジケーター。 |
error_message |
USPS データの取得に関するエラー メッセージ。人為的に作成された住所が検出されたために USPS の処理が一時停止された場合に入力されます。 このエラーが表示されると、USPS データ フィールドにデータが入力されないことがあります。 |
cass_processed |
リクエストが CASS 処理されたことを示すインジケーター。 |
ValidateAddressRequest
住所を検証するためのリクエスト。
フィールド | |
---|---|
address |
必須。検証される住所。住所の形式が未設定の場合、 この入力のフィールドの長さは合計で 280 文字以内にする必要があります。 サポートされているリージョンについては、こちらをご覧ください。 入力アドレスの Address Validation API は、 |
previous_response_id |
最初の住所検証リクエストでは、このフィールドを空にする必要があります。1 つの住所を完全に検証するためにさらにリクエストが必要な場合(たとえば、最初の検証後にユーザーが行った変更を再検証する必要がある場合)、フォローアップ リクエストでは、検証シーケンスの最初のレスポンスの |
enable_usps_cass |
USPS CASS 互換モードを有効にします。これは コンポーネント化された |
language_options |
省略可。プレビュー: この機能はプレビュー版(pre-GA)です。一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、一般提供前のプロダクトや機能の変更は、他の一般提供前のバージョンと互換性がない場合があります。pre-GA のサービスには、Google Maps Platform サービス固有の規約が適用されます。詳細については、リリース ステージの説明をご覧ください。 Address Validation API がレスポンスに追加情報を含めることを有効にします。 |
session_token |
省略可。オートコンプリート セッションを課金目的で識別する文字列。長さが 36 文字以下の ASCII 文字の、URL とファイル名に安全な base64 文字列にする必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。 セッションは、ユーザーがオートコンプリート クエリを実行すると開始され、場所を選択して Place Details または Address Validation が呼び出されると終了します。各セッションでは、複数の Autocomplete クエリの後に 1 つの Place Details または Address Validation リクエストが続きます。セッション内の各リクエストに使用される認証情報は、同じ Google Cloud コンソール プロジェクトに属している必要があります。セッションが終了するとトークンは無効になります。アプリでセッションごとに新しいトークンを生成する必要があります。 注: Address Validation は Autocomplete (New) API のセッションでのみ使用できます。Autocomplete API では使用できません。詳しくは、https://developers.google.com/maps/documentation/places/web-service/session-pricing をご覧ください。 |
ValidateAddressResponse
住所検証リクエストに対するレスポンス。
フィールド | |
---|---|
result |
住所検証の結果。 |
response_id |
このレスポンスを識別する UUID。アドレスを再検証する必要がある場合は、この UUID を新しいリクエストに含める必要があります。 |
ValidationResult
住所の検証結果。
フィールド | |
---|---|
verdict |
全体の判定フラグ |
address |
ジオコードではなく、住所自体に関する情報。 |
geocode |
住所がジオコーディングされた場所と場所に関する情報。 |
metadata |
配送可能性に関するその他の情報。Address Validation API に送信されるすべての住所に対して、 |
usps_data |
USPS が提供する追加の配送フラグ。リージョン |
english_latin_address |
プレビュー: この機能はプレビュー版(pre-GA)です。一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、一般提供前のプロダクトや機能の変更は、他の一般提供前のバージョンと互換性がない場合があります。pre-GA のサービスには、Google Maps Platform サービス固有の規約が適用されます。詳細については、リリース ステージの説明をご覧ください。 英語に翻訳された住所。 変換された住所を API 入力として再利用することはできません。サービスにより、ユーザーは最初に提供された住所の検証を母国語で確認または拒否できます。 住所の一部に英語の翻訳がない場合、サービスはラテン文字を使用した代替言語でその部分を返します。代替言語が選択される仕組みについては、こちらをご覧ください。住所の一部にラテン文字を使用する言語の翻訳や文字変換がない場合、サービスは住所に関連付けられたローカル言語でその部分を返します。 この出力を有効にするには、 注: |
判断
住所検証の結果とジオコードの概要。
フィールド | |
---|---|
input_granularity |
入力アドレスの粒度。これは入力住所の解析結果であり、検証シグナルは得られません。検証シグナルについては、下記の たとえば、入力住所に特定のアパート番号が含まれている場合、ここでの |
validation_granularity |
API が住所を完全に検証できる粒度レベル。validateたとえば、 住所ごとのコンポーネントの検証結果は、 |
geocode_granularity |
これは上記の |
address_complete |
未解決のトークンや想定外の住所要素、欠落している住所がなければ、住所は完全とみなされます。設定されていない場合は、値が |
has_unconfirmed_components |
分類または検証ができない住所コンポーネントが 1 つ以上あります。詳しくは、 |
has_inferred_components |
入力に含まれていない住所コンポーネントが推定(追加)されました。詳しくは、 |
has_replaced_components |
少なくとも 1 つの住所コンポーネントが置き換えられました。詳しくは、 |
粒度
住所またはジオコードに含まれるさまざまな粒度。これらの値は、住所の粒度を示すために使用される場合、住所が送付先を識別する粒度を示します。たとえば、「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 |
その他のすべての粒度は、提供できないためまとめてバケットにまとめられます。 |