ニュージーランド (NZL)
このセクションでは、ニュージーランドでサポートされているジオコーディング データセット、操作、入力および出力フィールドの情報を示します。
サポートされているジオコーディング データセット
次の表に、ニュージーランドでサポートされているジオコーディング データセットと使用可能なジオコーディング レベルを示します。
ジオコーディング データセット | 都市セントロイド | 郊外/村セントロイド | 郵便番号セントロイド | ストリートセントロイド | 補間されたストリート住所 | ポイントレベル住所 | POI (ポイント情報) |
---|---|---|---|---|---|---|---|
Critchlow English | はい | はい | はい | はい | はい | はい | はい |
サポートされている操作
- ジオコーディング — 1 つ以上の住所を入力として受け取り、それに対応する緯度/経度座標などの情報を返します。
- リバース ジオコーディング — 1 つ以上の緯度/経度座標を入力として受け取り、その場所に対応する住所を返します。
入力フィールド
入力住所には、次の住所要素の一部またはすべてを含めることができます。
パラメータ | タイプ | 説明 |
---|---|---|
placeName | String | 入力住所に関連する建物名、場所名、POI (ポイント情報)、会社または企業名を示します。これはオプションです。 |
mainAddress | String | 単一行入力 — 他の住所フィールドが全く入力されていない場合、mainAddress の内容は単一行入力として処理されます。単一行入力は、複数の入力住所フィールドで構成することができます。これらのフィールドは、その国の通常の住所の順序で入力する必要があります。詳細については、以下の「単一行入力」セクションを参照してください。 通りの住所 — 郵便住所の一部 (都市、郵便番号など) が分けて入力されたり、LastLine フィールドに入力されたりする場合、mainAddress の内容が通りの住所の部分として処理され、会社名、家番号、建物名、通り名を含めることができます。これはオプションです。 交差点の入力—交差点を入力するには、2 個のアンパサンド (&&) で区切られた 2 つのストリート名を指定します。 |
lastLine | String | 住所の最終行。これはオプションです。例: 56 Namata Road |
areaName1 | String | 地方 (region) を指定します。地方は、同国の行政区分です。これはオプションです。 |
areaName2 | String | 未使用。 |
areaName3 | String | 都市または町を指定します。これはオプションです。 |
areaName4 | String | 郊外を指定します。これはオプションです。 |
postalCode | String | 4 桁の郵便番号。最初の桁は地図上の地域を表します。2 桁目と 3 桁目は郵便仕分けエリアを表します。最後の桁は特定の市内エリア、地方配送、または私書箱室を表します。これはオプションです。 |
country | String | 3 文字の ISO 3166-1 Alpha-3 国コード。ニュージーランドの国コードは NZL です。フォワード ジオコーディングに必須です。 |
ニュージーランドの住所のガイドライン
最適なマッチングとジオコーディング結果が得られるように、次の推奨事項に従って、入力住所データをできる限り最良のフォーマットにしてください。ニュージーランドの住所の詳細については、New Zealand Post の Web サイト (www.nzpost.co.nz) を参照してください。
- 必須のフィールド — 住所には必ず都市名または郵便番号を含める必要があります。
- 郊外のエイリアス — ジオコーダは、正式に認識されている郊外名以外に、ローカルに使用されている郊外名をサポートしています。例えば、Rosedale は正式な郊外名 Hargest のエイリアスです。
- 大ストリートタイプ — 入出力における大ストリートタイプとその一般的な略語は認識され、完全に対応済みです。
- 一般的な語および略語 — ジオコーダは、住所に含まれる一般的な語、方角、家番号を指す記号、および略語を認識し、このような住所のジオコーディングを正しく実行できます。
- 数字、数字に相当する文字、および序数 — 番号が付けられたストリートは、名前に読み替えたストリート名に変換されます。入力住所に含まれる序数も認識されます。
単一行入力
住所の各要素を別々のフィールドに入力する代わりに、住所要素を次の順序で並べた住所全体を mainAddress 入力フィールドに入力できます。
[unit_info][address_number][street_info][areaName4][areaName3][postal_code]
説明:- [unit_info] は、ユニットのタイプおよび値です。これはオプションです。
- [address_number] は省略可能です。
- [street_info] は、ストリート名、ストリート タイプ、何らかの前置または後置方位記号 (例: East、West など) の情報で構成されます。
- [areaName4] は郊外です。
- [areaName3] は都市です。
- [postal_code] は 4 桁の郵便番号です。
- [areaName3] と [postal_code] のどちらかが必須です。
最適な結果を得るためには、ストリート情報と最後の住所行情報との間にカンマを入れます。
カスタム オプション
次の表に、ニュージーランドに固有のオプションを示します。このカスタム フィールドは、ジオコーディング操作に適用可能であり、オプションの入力パラメータとなります。すべての国とその定義で使用可能なオプションの標準セットについては、Geocode サービスおよび Reverse Geocode サービスについて説明している章を参照してください。
オプション名 | 説明 |
---|---|
ReturnOriginalCoordinates | true に設定されている場合、ORIGINAL_LONGITUDE および ORIGINAL_LATITUDE の値を候補のカスタム出力フィールドで返します。 |
出力フィールド
以下の表に、ニュージーランドに所在する候補に対して返される住所フィールドの一覧を示します。
フィールド名 | 説明 |
---|---|
mainAddressLine | ストリート住所。会社名、家番号、建物名、ストリート名を含めることができます。 |
addressLastLine | 住所の最終行。 |
placeName | 住所に関連する建物名、場所名、POI (ポイント情報)、会社または企業名。 |
areaName1 | 地域 (region)。 |
areaName2 | 未使用。 |
areaName3 | 都市または町。 |
areaName4 | 郊外。 |
postCode1 | 4 桁の郵便番号。 |
postCode2 | 未使用。 |
country | 3 文字の ISO 3166-1 Alpha-3 国コード。ニュージーランドの国コードは NZL です。 |
addressNumber | 住所番号。 |
streetName | ストリートまたは道路の名前。 |
unitType | ユニット タイプ (APT、STE など)。 |
unitValue | ユニットの値/番号。"3B" など。 |
customFields | 次の表に、ニュージーランドのカスタム フィールドを示します。 |
カスタム出力フィールド
以下の表に、ニュージーランドのみで使われる出力フィールドを示します。特に記載のない限り、これらのフィールドは、フォワード ジオコーディングとリバース ジオコーディングの両方で返すことができます。
名前 | 説明 |
---|---|
ALIASED_SUBURB | ニュージーランドの郊外のエイリアス。正式に認識されている郊外名の代替名。 |
KEY_UFI | ニュージーランド UFI。この一意識別子 (UFI) は、ジオコーディングされた住所が属するストリートセグメントを識別します。UFI は、New Zealand Post によって割り当てられる最大 7 桁の数字列であり、各郵便配達ポイントを一意に識別します。利用可能な場合は UFI が常に返されますが、入力には UFI を使用できません。 |
NZL_MESHBLOCK_ID | ニュージーランド Meshblock 識別子。Meshblock は、ニュージーランド統計局が統計データを収集するために作成した最も小さい地理的な単位です。Meshblock のサイズは、街区の一部から地方の広いエリアまでさまざまです。 |
ORIGINAL_LATITUDE | 元の緯度値。 |
ORIGINAL_LONGITUDE | 元の経度値。 |