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 によって拒否されませんが、情報は破棄され、レスポンスで返されることはありません。