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 は現在使用していません。現時点では、このフィールドが設定されたリクエストは API で拒否されませんが、この情報は破棄され、レスポンスでは返されません。
organization

string

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