Address Validation (beta)

AddressValidation クラス

google.maps.addressValidation.AddressValidation クラス

注意: v=beta チャンネルでのみ使用できます。

AddressValidation API にアクセスするための静的クラス。

const {AddressValidation} = await google.maps.importLibrary("addressValidation") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。

静的メソッド
fetchAddressValidation	注意: v=beta チャンネルでのみ使用できます。 fetchAddressValidation(request) パラメータ:  request:  AddressValidationRequest 戻り値:  Promise<AddressValidation> 住所を検証します。https://developers.google.com/maps/documentation/javascript/address-validation/validate-address をご覧ください。

プロパティ
address	注意: v=beta チャンネルでのみ使用できます。 タイプ:  Address optional ジオコードではなく、住所そのものに関する情報。
geocode	注意: v=beta チャンネルでのみ使用できます。 タイプ:  Geocode optional 住所のジオコーディング先の場所とスポットに関する情報。
metadata	注意: v=beta チャンネルでのみ使用できます。 タイプ:  AddressMetadata optional 配信可能性に関連するその他の情報。Address Validation API に送信されるすべてのアドレスに対して metadata が完全に設定される保証はありません。
responseId	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional このレスポンスを識別する UUID。住所の再検証が必要な場合は、この UUID を新しいリクエストに含める必要があります。
uspsData	注意: v=beta チャンネルでのみ使用できます。 タイプ:  USPSData optional USPS が提供する配送可能性に関する追加のフラグ。リージョン US と PR でのみ提供されます。
verdict	注意: v=beta チャンネルでのみ使用できます。 タイプ:  Verdict optional 全体的な判定フラグ

メソッド
toJSON	注意: v=beta チャンネルでのみ使用できます。 toJSON() パラメータ: なし 戻り値:  Object AddressValidation クラスを同じプロパティを持つ JSON オブジェクトに変換します。

AddressValidationRequest インターフェース

google.maps.addressValidation.AddressValidationRequest インターフェース

注意: v=beta チャンネルでのみ使用できます。

AddressValidation.fetchAddressValidation のリクエスト インターフェース。

プロパティ
address	注意: v=beta チャンネルでのみ使用できます。 タイプ:  PostalAddressLiteral 検証中の住所。書式設定されていない住所は、PostalAddress.addressLines から送信してください。
previousResponseId optional	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional このフィールドは、最初のアドレス検証リクエストでは設定しないでください。1 つの住所を完全に検証するために複数のリクエストが必要な場合（たとえば、最初の検証後にユーザーが行った変更を再検証する必要がある場合）、後続の各リクエストで、検証シーケンスの最初に応答された AddressValidation.responseId をこのフィールドに入力する必要があります。
uspsCASSEnabled optional	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean optional USPS CASS 互換モードを有効にします。これは AddressValidation の AddressValidation.uspsData フィールドにのみ影響します。注: USPS CASS 対応のリクエストでプエルトリコの住所を指定する場合は、address の PostalAddress.regionCode を「PR」として指定するか、address の PostalAddress.administrativeArea を「Puerto Rico」（大文字と小文字を区別しない）または「PR」として指定する必要があります。

Address クラス

google.maps.addressValidation.Address クラス

注意: v=beta チャンネルでのみ使用できます。

後処理された住所の詳細。後処理では、住所のスペルミスを修正したり、誤った部分を置き換えたり、欠落した部分を推測したりします。

const {Address} = await google.maps.importLibrary("addressValidation") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。

プロパティ
components	注意: v=beta チャンネルでのみ使用できます。 タイプ:  Array<AddressComponent> 形式が設定され修正された住所の個々の住所コンポーネントと、検証情報。これにより、個々のコンポーネントの検証ステータスに関する情報が提供されます。
formattedAddress	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 後処理された住所。住所が所在する地域の住所形式ルールに従って 1 行の住所としてフォーマットされます。
missingComponentTypes	注意: v=beta チャンネルでのみ使用できます。 タイプ:  Array<string> 正しい形式の住所に存在することが想定されるが、入力には存在せず、推測もできないコンポーネントのタイプ。このタイプのコンポーネントは、formatted_address、postal_address、address_components には存在しません。たとえば、「Boulder, Colorado, 80301, USA」という入力に対して ['street_number', 'route'] が返されることがあります。使用可能なタイプのリストについては、こちらをご覧ください。
postalAddress	注意: v=beta チャンネルでのみ使用できます。 タイプ:  PostalAddress optional 郵便住所として表される後処理済み住所。
unconfirmedComponentTypes	注意: v=beta チャンネルでのみ使用できます。 タイプ:  Array<string> address_components に存在するが、正しいことを確認できなかったコンポーネントのタイプ。このフィールドは便宜上提供されています。その内容は、address_components を反復処理して、AddressComponent.confirmationLevel が ConfirmationLevel.CONFIRMED ではないか、AddressComponent.inferred フラグが true に設定されていないすべてのコンポーネントのタイプを見つけることと同等です。使用可能なタイプのリストについては、こちらをご覧ください。
unresolvedTokens	注意: v=beta チャンネルでのみ使用できます。 タイプ:  Array<string> 解決できなかった入力内のトークン。これは、住所の有効な部分として認識されなかった入力である可能性があります（たとえば、「123235253253 Main St, San Francisco, CA, 94105」という入力では、有効な番地ではないため、未解決のトークンは ["123235253253"] のように見えることがあります）。

AddressComponent クラス

google.maps.addressValidation.AddressComponent クラス

注意: v=beta チャンネルでのみ使用できます。

住所の 1 つのコンポーネント（町名、市区町村など）を表します。

const {AddressComponent} = await google.maps.importLibrary("addressValidation") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。

プロパティ
componentName	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional コンポーネント名のテキスト。たとえば、通り名の場合は「5th Avenue」、番地の場合は「1253」などです。
componentNameLanguageCode	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional BCP-47 言語コード。コンポーネント名が言語に関連付けられていない場合（番地など）、これは存在しません。
componentType	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 住所コンポーネントのタイプ。使用可能なタイプのリストについては、表 2: プレイス サービスで返されるその他のタイプをご覧ください。
confirmationLevel	注意: v=beta チャンネルでのみ使用できます。 タイプ:  ConfirmationLevel optional コンポーネントが正しいことの確実性レベルを示します。
inferred	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean true の場合、このコンポーネントは入力の一部ではありませんでしたが、住所の位置情報から推測されました。完全な住所には、このコンポーネントを含めることが推奨されます。
replaced	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean コンポーネントの名前がまったく別の名前に置き換えられたことを示します。たとえば、間違った郵便番号を住所に合った正しい郵便番号に置き換えるなどです。これは外観上の変更ではなく、入力コンポーネントが別のものに変更されています。
spellCorrected	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean コンポーネント名のスペルミスを修正したことを示します。API は、「centre」から「center」のように、スペルが異なるだけの変更を常に検出するわけではありません。
unexpected	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean true の場合、このコンポーネントは指定された地域の住所に存在しないことが想定されます。入力の一部であったため、保持されています。

AddressMetadata クラス

google.maps.addressValidation.AddressMetadata クラス

注意: v=beta チャンネルでのみ使用できます。

住所のメタデータ。Address Validation API に送信されるすべてのアドレスに対して AddressMetadata が完全に設定される保証はありません。

const {AddressMetadata} = await google.maps.importLibrary("addressValidation") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。

プロパティ
business	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean
poBox	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean
residential	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean

ConfirmationLevel 定数

google.maps.addressValidation.ConfirmationLevel 定数

注意: v=beta チャンネルでのみ使用できます。

コンポーネントが正しいことの確実性のレベルを示すさまざまな値。

const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。

定数
CONFIRMED	注意: v=beta チャンネルでのみ使用できます。
UNCONFIRMED_AND_SUSPICIOUS	注意: v=beta チャンネルでのみ使用できます。
UNCONFIRMED_BUT_PLAUSIBLE	注意: v=beta チャンネルでのみ使用できます。

Geocode クラス

google.maps.addressValidation.Geocode クラス

注意: v=beta チャンネルでのみ使用できます。

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

const {Geocode} = await google.maps.importLibrary("addressValidation") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。

プロパティ
bounds	注意: v=beta チャンネルでのみ使用できます。 タイプ:  LatLngBounds optional ジオコーディングされた場所の境界。
featureSizeMeters	注意: v=beta チャンネルでのみ使用できます。 タイプ:  number optional ジオコード化された場所のサイズ（メートル単位）。これは、ジオコーディングされた位置の粗さを測定する別の方法ですが、意味ではなく物理的なサイズで測定します。
location	注意: v=beta チャンネルでのみ使用できます。 タイプ:  LatLngAltitude optional 入力のジオコーディングされた位置。
placeId	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional ジオコーディングされた場所のプレイス ID。住所、緯度/経度座標、Plus Code よりも Place の使用が推奨されます。ルーティングや運転ルートの計算に座標を使用すると、常にその座標に最も近い道路にポイントがスナップされます。この道路は、目的地に迅速かつ安全に到達できる道路ではない可能性があり、物件へのアクセス ポイントの近くにない可能性があります。また、位置情報のリバース ジオコーディングでは、返される住所が元の住所と一致する保証はありません。
placeTypes	注意: v=beta チャンネルでのみ使用できます。 タイプ:  Array<string> 入力がジオコーディングされた場所のタイプ。たとえば、['locality', 'political'].タイプの一覧については、Geocoding API のドキュメントをご覧ください。
plusCode	注意: v=beta チャンネルでのみ使用できます。 タイプ:  PlusCode optional location に対応する Plus Code。

メソッド
fetchPlace	注意: v=beta チャンネルでのみ使用できます。 fetchPlace() パラメータ: なし 戻り値: なし この Geocode の Place 表現を返します。場所の詳細情報を取得するには、place.fetchFields() を呼び出す必要があります。

粒度定数

google.maps.addressValidation.Granularity 定数

注意: v=beta チャンネルでのみ使用できます。

住所またはジオコードが持つことができるさまざまな粒度。address の粒度を示すために使用される場合、これらの値は、アドレスがどの程度の粒度で宛先を識別するかを示します。たとえば、「123 Main Street, Redwood City, CA, 94061」のような住所は PREMISE を識別しますが、「Redwood City, CA, 94061」のような住所は LOCALITY を識別します。ただし、Redwood City の「123 Main Street」のジオコードが見つからない場合、住所はより詳細であっても、返されるジオコードは LOCALITY の粒度になる可能性があります。

const {Granularity} = await google.maps.importLibrary("addressValidation") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。

定数
BLOCK	注意: v=beta チャンネルでのみ使用できます。 住所またはジオコードがブロックを示している。日本など、ブロックレベルのアドレス指定がある地域でのみ使用されます。
OTHER	注意: v=beta チャンネルでのみ使用できます。 その他のすべての粒度。配信できないため、まとめてバケット化されます。
PREMISE	注意: v=beta チャンネルでのみ使用できます。 建物レベルの結果。
PREMISE_PROXIMITY	注意: v=beta チャンネルでのみ使用できます。 住所の建物の位置を近似するジオコード。
ROUTE	注意: v=beta チャンネルでのみ使用できます。 ジオコードまたは住所は、ルート（道路、道路、高速道路など）まで細かく指定されています。
SUB_PREMISE	注意: v=beta チャンネルでのみ使用できます。 建物内の結果（アパートなど）。

USPSAddress クラス

google.maps.addressValidation.USPSAddress クラス

注意: v=beta チャンネルでのみ使用できます。

米国の住所の USPS 表現。

const {USPSAddress} = await google.maps.importLibrary("addressValidation") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。

プロパティ
city	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 市区町村名。
cityStateZipAddressLine	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 市区町村、都道府県、郵便番号を含む住所行。
firm	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 会社の名前。
firstAddressLine	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 住所の 1 行目。
secondAddressLine	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 住所の 2 行目。
state	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 2 文字の州コード。
urbanization	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional プエルトリコの都市化の名前。
zipCode	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 郵便番号（例: 10009）。
zipCodeExtension	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 4 桁の郵便番号指定オプション（例: 5023）。

USPSData クラス

google.maps.addressValidation.USPSData クラス

注意: v=beta チャンネルでのみ使用できます。

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

const {USPSData} = await google.maps.importLibrary("addressValidation") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。

プロパティ
abbreviatedCity	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 省略された都市名。
addressRecordType	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 入力された住所と一致する住所レコードのタイプ。
carrierRoute	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 配達ルートのコード。1 文字のプレフィックスと 3 桁のルート指定子で構成される 4 文字のコード。
carrierRouteIndicator	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 携帯通信会社のルートレートの並べ替えインジケーター。
cassProcessed	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean リクエストが CASS 処理されたことを示すインジケーター。
county	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 郡名。
deliveryPointCheckDigit	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 配送ポイントのチェック ディジット。この番号は、機械でスキャンされた郵便物の delivery_point_barcode の末尾に追加されます。delivery_point_barcode、delivery_point_check_digit、郵便番号、ZIP+4 のすべての数字を足すと、10 で割り切れる数になります。
deliveryPointCode	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 2 桁の配送ポイント コード。
dpvCMRA	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 住所が CMRA（Commercial Mail Receiving Agency）かどうかを示します。CMRA は、クライアントのメールを受け取る民間企業です。1 文字を返します。
dpvConfirmation	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional DPV 確認の有効な値。1 文字を返すか、値を返しません。
dpvDoorNotAccessible	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional フラグは、USPS がドアをノックして郵便物を配達できない住所を示します。1 文字を返します。
dpvDrop	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional フラグは、メールがサイトの 1 つの受取場所に配達されることを示します。1 文字を返します。
dpvEnhancedDeliveryCode	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 住所に対して複数の DPV 戻りコードが有効であることを示します。1 文字を返します。
dpvFootnote	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 配送ポイントの検証からの脚注。複数の脚注を同じ文字列に連結できます。
dpvNonDeliveryDays	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional フラグは、メール配信が毎日行われないことを示します。1 文字を返します。
dpvNonDeliveryDaysValues	注意: v=beta チャンネルでのみ使用できます。 タイプ:  number optional 配達されない日を識別する整数。ビットフラグを使用して照会できます。0x40 - 日曜日は配達不可 0x20 - 月曜日は配達不可 0x10 - 火曜日は配達不可 0x08 - 水曜日は配達不可 0x04 - 木曜日は配達不可 0x02 - 金曜日は配達不可 0x01 - 土曜日は配達不可
dpvNoSecureLocation	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional ドアにアクセスできるが、セキュリティ上の懸念から荷物は配達されないことを示すフラグ。1 文字を返します。
dpvNoStat	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 住所が統計なしの住所か、有効な住所かを示します。No stat addresses は、継続的に占有されていない住所、または USPS がサービスを提供していない住所です。1 文字を返します。
dpvNoStatReasonCode	注意: v=beta チャンネルでのみ使用できます。 タイプ:  number optional NoStat タイプを示します。理由コードを整数として返します。
dpvPBSA	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional アドレスが PBSA レコードと一致したことを示します。1 文字を返します。
dpvThrowback	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional メールが住所に配達されないことを示します。1 文字を返します。
dpvVacant	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 住所が空いているかどうかを示します。1 文字を返します。
elotFlag	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional eLOT 昇順/降順フラグ（A/D）。
elotNumber	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional Enhanced Line of Travel（eLOT）番号。
errorMessage	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional USPS のデータ取得に関するエラー メッセージ。これは、人工的に作成された住所が検出されたために USPS の処理が一時停止された場合に設定されます。
fipsCountyCode	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional FIPS 郡コード。
hasDefaultAddress	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean デフォルトのアドレスが見つかったが、より具体的なアドレスが存在することを示すインジケーター。
hasNoEWSMatch	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean 配送先住所は一致しますが、EWS ファイルには完全一致がまもなく利用可能になることが示されています。
lacsLinkIndicator	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional LACSLink インジケーター。
lacsLinkReturnCode	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional LACSLink の戻りコード。
pmbDesignator	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional PMB（私書箱）ユニット指定子。
pmbNumber	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional PMB（Private Mail Box）番号。
poBoxOnlyPostalCode	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean 私書箱専用の郵便番号。
postOfficeCity	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 主要な郵便局の市区町村。
postOfficeState	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional メインの郵便局の状態。
standardizedAddress	注意: v=beta チャンネルでのみ使用できます。 タイプ:  USPSAddress optional USPS の標準化された住所。
suiteLinkFootnote	注意: v=beta チャンネルでのみ使用できます。 タイプ:  string optional 街路または高層ビルのレコードと部屋番号情報を照合した結果の脚注。ビジネス名の照合で一致が見つかった場合、セカンダリ番号が返されます。

Verdict クラス

google.maps.addressValidation.Verdict クラス

注意: v=beta チャンネルでのみ使用できます。

指定された住所の後処理済み住所を表します。

const {Verdict} = await google.maps.importLibrary("addressValidation") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。

プロパティ
addressComplete	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean 未解決のトークンがなく、予期しない住所コンポーネントや欠落している住所コンポーネントがない場合、住所は完全であると見なされます。設定されていない場合、値が false であることを示します。詳細については、Address.missingComponentTypes、Address.unresolvedTokens、AddressComponent.unexpected フィールドをご覧ください。
geocodeGranularity	注意: v=beta チャンネルでのみ使用できます。 タイプ:  Granularity optional Geocode の粒度に関する情報。これは、ジオコーディングされた位置の粗さまたは細かさのセマンティックな意味として理解できます。
hasInferredComponents	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean 入力に含まれていないアドレス コンポーネントが 1 つ以上推測（追加）されました。詳しくは、AddressComponent をご覧ください。
hasReplacedComponents	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean optional 少なくとも 1 つのアドレス コンポーネントが置き換えられました。詳しくは、AddressComponent をご覧ください。
hasUnconfirmedComponents	注意: v=beta チャンネルでのみ使用できます。 タイプ:  boolean 少なくとも 1 つの住所コンポーネントを分類または検証できません。詳しくは、AddressComponent をご覧ください。
inputGranularity	注意: v=beta チャンネルでのみ使用できます。 タイプ:  Granularity optional 入力アドレスの粒度。これは入力アドレスの解析結果であり、検証シグナルは提供されません。検証シグナルについては、validationGranularity を参照してください。
validationGranularity	注意: v=beta チャンネルでのみ使用できます。 タイプ:  Granularity optional API がアドレスを完全に検証できる粒度レベル。たとえば、validationGranularity が PREMISE の場合、PREMISE 以上のレベルのすべての住所コンポーネントを検証できることを示します。