Package google.type

インデックス

LatLng

緯度と経度のペアを表すオブジェクト。これは緯度を表す倍精度値と経度を表す倍精度値のペアで表現されます。特に明記されていない場合、このオブジェクトは WGS84 規格に準拠する必要があります。値は正規化範囲内で指定する必要があります。

フィールド
latitude

double

緯度（度単位）。範囲 [-90.0, +90.0] 内になければなりません。
longitude

double

経度（度単位）。範囲 [-180.0, +180.0] 内になければなりません。

PostalAddress

郵便の配達先や支払場所などに使用される住所を表します。郵便住所がわかっていれば、郵便サービスによって住宅や私書箱などに商品を配達できます。これは地理的な場所（道路、町、山）を指し示すものではありません。

通常の用途では、住所はユーザーによる入力か既存データのインポートによって作成されます（プロセスの種類によります）。

住所の入力または編集に関するアドバイス: - 国際化対応の住所ウィジェット（https://github.com/google/libaddressinput など）を使用してください。- フィールドの入力または編集に使用する UI 要素は、そのフィールドが使用されない国ではユーザーに表示しないでください。

このスキーマの使用方法の詳細については、https://support.google.com/business/answer/6397478 をご覧ください。

フィールド
revision

int32

PostalAddress のスキーマ リビジョン。0 以外の値を指定すると、API から INVALID_ARGUMENT エラーが返されます。
region_code

string

省略可。住所の国 / 地域に対応する CLDR 地域コード。詳細については、https://cldr.unicode.org/ と https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html をご覧ください。例: スイスの場合は「CH」です。地域コードが指定されていない場合は、住所から推測されます。最適なパフォーマンスを得るには、地域コードがわかっている場合はそのコードを含めることをおすすめします。リージョンが不整合または重複していると、パフォーマンスが低下する可能性があります。たとえば、address_lines にすでにリージョンが含まれている場合は、このフィールドにリージョン コードを再度指定しないでください。サポートされているリージョンについては、よくある質問をご覧ください。
language_code

string

入力アドレスの言語コードは将来の使用のために予約されており、現在は無視されます。API は、住所が存在する地域に適した言語で住所を返します。
postal_code

string

省略可。住所の郵便番号。すべての国で郵便番号の使用や存在を必要としているわけではありませんが、使用されている場合は、住所の他の部分で追加の確認が行われることがあります（例: 米国での州 / 郵便番号の確認）。
sorting_code

string

省略可。追加の国固有の並べ替えコード。ほとんどの地域では、これは使用されていません。使用される場合、値は「CEDEX」のような文字列で、その後に必要に応じて数字を付けたもの（例: 「CEDEX 7」）や、数字だけのものがあります。たとえば、ジャマイカの「セクターコード」、マラウイの「配達区域インジケータ」、コートジボワールの「郵便局インジケータ」などです。
administrative_area

string

省略可。その国 / 地域の住所に使用される最上位の行政区域。たとえば、州、省、都道府県などがこれに該当します。特にスペインでは、これは自治州ではなく県になります（例: 「カタルーニャ」ではなく「バルセロナ」）。州や県などの行政区画が住所表記に使用されない国もあります。たとえば、スイスではこの項目を空のままにします。
locality

string

省略可。通常は住所の市区町村の部分を指します。たとえば、米国の市、イタリアのコムーネ、英国の郵便町です。国 / 地域によっては、これに相当する地域区分が明確に定義されていない場合や、この構造にうまく適合しない場合がありますが、その場合は locality を空のままにして address_lines を使用します。
sublocality

string

省略可。住所の市町村部分の下位の区画。たとえば、字、特別区、地区などがこれに該当します。
address_lines[]

string

必須。住所の下位部分を記述する非構造化の住所行。

address_lines の値は型情報を持たず、1 つのフィールドに複数の値が含まれることもあるため（例: "Austin, TX"）、行の順序が明確であることが重要です。所在地の行の順序は、その住所の国や地域での「あて名書きの順序」にしてください。

住所として認められる最小限の体系化表現は、address_lines に配置されるすべての情報で構成されます。region_code が指定されていない場合、リージョンは住所から推測されます。

完全に構造化されていない住所を処理するには、住所のどの部分が地域区分や行政区域であるかを推測するのではなく、address_lines のみを含む住所を作成してからジオコーディングを行うことをおすすめします。
recipients[]

string

このフィールドは設定しないでください。現在、Address Validation API では使用されていません。現時点では、このフィールドが設定されたリクエストは拒否されませんが、情報は破棄され、レスポンスで返されることはありません。
organization

string

このフィールドは設定しないでください。Address Validation API では現在使用されていません。現時点では、このフィールドが設定されたリクエストは拒否されませんが、情報は破棄され、レスポンスで返されることはありません。