目次
LatLng
(メッセージ)PostalAddress
(メッセージ)
LatLng
緯度と経度のペアを表すオブジェクト。これは緯度を表す倍精度値と経度を表す倍精度値のペアで表現されます。特に明記されていない場合、このオブジェクトは WGS84 規格に準拠する必要があります。値は正規化範囲内で指定する必要があります。
フィールド | |
---|---|
latitude |
緯度(度単位)。範囲 [-90.0, +90.0] 内になければなりません。 |
longitude |
経度(度単位)。範囲 [-180.0, +180.0] 内になければなりません。 |
PostalAddress
郵便の配達先や支払場所などに使用される住所を表します。郵便住所がわかっていれば、郵便サービスによって住宅や私書箱などに商品を配達できます。これは地理的な場所(道路、町、山)を指し示すものではありません。
通常の用途では、住所はユーザーによる入力か既存データのインポートによって作成されます(プロセスの種類によります)。
住所の入力または編集に関するアドバイス: - https://github.com/google/libaddressinput など、多言語対応の住所ウィジェットを使用します。- フィールドの入力や編集に使用する UI 要素は、そのフィールドが使用されている国以外ではユーザーに表示しないでください。
このスキーマの使用方法の詳細については、https://support.google.com/business/answer/6397478 をご覧ください。
フィールド | |
---|---|
revision |
|
region_code |
(省略可)住所の国 / 地域に対応する CLDR 地域コード。詳しくは、https://cldr.unicode.org/ と https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html をご覧ください。例: スイスの場合は「CH」。地域コードを指定しない場合は、住所から推定されます。最高のパフォーマンスを得るには、わかっている場合は地域コードを含めることをおすすめします。地域が一致しない場合や、地域が繰り返されている場合、パフォーマンスが低下することがあります。たとえば、 |
language_code |
入力住所の言語コードは将来の使用のために予約されており、現在は無視されています。API は、住所がある場所に対応した言語で住所を返します。 |
postal_code |
(省略可)住所の郵便番号。国によっては郵便番号が使用されていない場合や、指定する必要がない場合もありますが、使用されている場合は住所の他の部分と組み合わせて追加の検証を行うことができます(例: 米国での州と郵便番号の検証)。 |
sorting_code |
(省略可)国固有の付加的な並べ替えコード。ほとんどの地域では、これは使用されていません。使用されている場合、値は「CEDEX」のような文字列か(その後に数字を付加した「CEDEX 7」のような形式の場合もあります)、数字のみとなります。たとえば、ジャマイカの「セクターコード」、マラウイの「配達区域インジケーター」、コートジボワールの「郵便局インジケーター」などがこれに該当します。 |
administrative_area |
(省略可)その国 / 地域の郵便住所に使用される最上位の行政区域。たとえば、州、省、都道府県などがこれに該当します。特にスペインでは、これは自治州ではなく県になります(例: 「カタルーニャ」ではなく「バルセロナ」)。州や県などの行政区域が郵便住所に使用されない国もあります。たとえば、スイスではこの項目を空のままにします。 |
locality |
(省略可)通常は住所の市区町村の部分を指します。たとえば、米国の市、イタリアのコムーネ、英国の郵便町です。国 / 地域によっては、これに相当する地域区分が明確に定義されていない場合や、この構造にうまく適合しない場合がありますが、その場合は locality を空のままにして address_lines を使用します。 |
sublocality |
(省略可)住所の市区町村部分より下位の区分。たとえば、字、特別区、地区などがこれに該当します。 |
address_lines[] |
必須。構造化されていない住所の下位部分を記述する行。 |
recipients[] |
このフィールドは設定しないでください。Address Validation API は現在使用していません。現時点では、このフィールドが設定されたリクエストは API で拒否されませんが、この情報は破棄され、レスポンスでは返されません。 |
organization |
このフィールドは設定しないでください。Address Validation API は現在使用していません。現時点では、このフィールドが設定されたリクエストは API で拒否されませんが、この情報は破棄され、レスポンスでは返されません。 |