ジオコードリソース

リクエストへの追加の入力を提供するキーと値のペア。 一覧表の詳細については、「追加のデータパラメータ」を参照してください。 キーと値は、を使用して区切り ,ます。 複数のキーと値のペアは、次のものを使用して区切ります ;。

additionaldata=<Key1>,<Value1>;<Key2>,<Value2>;...

例 :

additionaldata=PreserveUnitDesignators,true;
IncludeZipAddon,true

応答データに要素が含まれているコンマ区切りのリスト。

一覧表 [country, state, county, city, district、 subdistrict、 street、 houseNumber、 postalCode、 addressLines additionalData]

省略形 : [ctr, sta, cty, cit, dis, sdi, str、 hnr、 pst、 aln、 add、]

デフォルトの応答 : を除くすべて addressLines

xs:string

Geocoder API で使用可能な認証オプションのいずれかで使用される、 20 バイトの Base64 URL セーフエンコード文字列。

アプリ ID/APP コードオプションを使用する場合は、すべてのリクエストに app_id と app_code を含める必要があります。 詳細については、『 Identity & Access Management 開発者ガイド』を参照してください。

xs:string

クライアント アプリケーションの認証に使用される 20 バイトの Base64 URL セーフエンコード文字列。

アプリ ID/APP コードオプションを使用する場合は、すべてのリクエストに app_id と app_code を含める必要があります。 詳細については、『 Identity & Access Management 開発者ガイド』を参照してください。

xs:string

A 43-byte Base64 URL-safe encoded string used for the authentication of the client application. As a logged in user, you can generate it at https://here-tech.skawa.fun/projects. API Keys never expire but you can invalidate your API Keys at any time. You cannot have more than two API Keys for one app at the same time.

apiKey すべてのリクエストにを含める必要があります。 詳細については、『 Identity & Access Management 開発者ガイド』を参照してください。

GeoBoundingBoxType も参照してください

空間フィルタのタイプ。 空間フィルタは、リクエスト内の他の属性の検索を制限します。 バウンディング ボックスは bbox 2 つの緯度と経度のペアで指定されます。 1 つ目のペアはバウンディング ボックスの左上隅を定義し、 2 つ目のペアは右下隅を設定します。 bbox 検索は現在似て mapview いますが、拡張されていません。 関連するグローバル結果も返されます。

bbox=<TopLeft.Latitude>,<TopLeft.Longitude>;
  <BottomRight.Latitude>,<BottomRight.Longitude>

xs: 文字列

xs: 文字列、完全一致

xs: 文字列、完全一致、単一の ISO 3166-1-alpha-3 国コード

• ハードカントリーフィルタとソフトカントリーフォーカスパラメータの両方がリクエストに設定されている場合、国フィルタがフォーカスよりも優先されます。 つまり、結果は国のフィルタで指定された国に限定されます。
• bbox mapview または、競合がある場合は、国の重点項目よりもフィルタが優先されます。

xs: 文字列

xs: 文字列

xs: 整数

このgenパラメータは、 API での下位互換性のない動作を有効または無効にします。 詳細および世代履歴については、同じ API の異なる世代の章を参照してください。 常に最新世代の製品を使用することをお勧めします。 現在、 gen= です9。

xs: 文字列、完全一致

番地または自宅名。

xs: 整数

1 に設定すると、各 JSON 応答属性名の最初の文字が小文字に設定されます。 デフォルト値は 0 です。

xs: 文字列

JSON 応答のラップに使用するユーザー定義関数の名前を指定します。

LanguageCodeType

結果の住所要素の優先言語。 Geocoder は、希望する言語を使用せずに、現地の人々が理解できるように、公式の国の言語または地域の主要言語で結果を返します。 言語コードは、 RFC 4647 標準に準拠して提供する必要があります。 パラメーター（言語）の複数形もサポートされています。 ただし、リスト内の最後に指定した言語のみが使用されます。 この時点では、上記の言語設定はすべて無視されます。

応答データに要素が含まれているコンマ区切りのリスト。

一覧表 [address, mapReference, mapView, addressDetails, streetDetails、 additionalData、 adminIds、 linkInfo、 adminInfo、 timeZone, addressNamesBilingual related.nearByAddress]

省略形 : [ar, mr, mv, dt, sd, ad, ai、 li、 in、 tz、 nb、 rn,]

adminIds このスイッチは、順方向ジオ コーディングでのみ使用できます。

タイムゾーン情報を取得するには、次 adminInfo のようにパラメータを追加する必要があります。 locationattributes=adminInfo,timeZone

逆方向のジオ コーディングの結果では、 locationattributes=none をオフにしない限り、 adminIds は常に存在します。 locationattributes=-adminIds は、逆方向のジオ コーディングの結果には影響を与えません。

related.nearByAddress このスイッチは trackPosition 、リバースジオ コーディングモードでのみ使用できます。

リバースジオ コーディング応答のデフォルト : address、 mapView、 additionalData、 mapReference、 adminIds。

転送ジオ コーディング応答のデフォルト : address、 mapView、 additionalData。

mapReference リンク PVID 、番地、管理エリアの PVID が応答データに含まれています。 で adminIdsは、管理エリアの PVID のみが存在します。

xs: 文字列、完全一致

物理的な場所を一意に識別するキー。 ジオコード応答の各レコードには、ロケーション ID が含まれています。 ID を使用して、正確に同じ場所の情報を取得します。 たとえば、「 1 Market Street, 94105 San Francisco 」のロケーション ID は NT_NVpegjQLOBK8ORYk3jV7A_xA です。

GeoBoundingBoxType を参照してください

アプリのビューポイントの地図座標を指定します。 は mapview 2 つの緯度と経度のペアで指定されます。最初のペアはバウンディング ボックスの左上隅を定義し、 2 番目のペアは右下隅を設定します。 設定されたマップ ビュー内の一致と拡張領域の一致が最も高いランク付けされます。 関連するグローバル結果も返されます。

mapview=<TopLeft.Latitude>,<TopLeft.Longitude>;
  <BottomRight.Latitude>,<BottomRight.Longitude>

xs: 整数

応答構造内の最大アイテム数を定義し、各応答ページに含まれる結果の数を制限します。 定義されている最大数を超える結果が得られると、別々の追加ページに返されます。 各応答構造 ( ページ ) には、次のページへのハンドルが含まれています。 たとえば、 maxresults=5 は、 1 つの応答ページにつき最大 5 つの結果を生成します。 合計で 8 つの結果がある場合、最初のページには 5 つの結果が含まれ、さらに結果が表示された 2 ページ目があることを示します。

"metaInfo: {
  timestamp: 2012-05-10T15:10:06.227+0000
  nextPageInformation: 2
}"

xs: 文字列

応答が複数のページに分割されたときに返されるページを識別するキー。 maxresults 元のリクエストでが指定されており、リクエストの応答に次のページがあることが示されている場合にのみ関連します。例 :

"metaInfo: {
  timestamp: 2012-05-10T15:10:06.227+0000
  nextPageInformation: 2
}"

xS: 文字列 (3 バイト、 ISO 3166-1-alpha-3)

政治的見解を指定します。 利用可能な地域は、この国の観点から見ることができます。 このパラメータが指定されていない場合は、中立的な国際ビューが利用可能になります。このビューでは、地域に未解決のクレームがある可能性があります。

サポートされているすべてのビューの一覧については、付録の「 Political View 」を参照してください。

Geocoder をサポートしていないすべての政治的ビューについて、はデフォルトのビューに戻ります。 たとえば、 politicalview=USA または politicalview=FRA は、どのような方法でも応答に影響を与えません。

xs: 文字列、完全一致

国の政府によって定義された郵便番号。

GeoProximityType 。 GeoProximityType も参照してください

prox=lat,lon,radius

SpatialFilter のタイプ。 空間フィルタは、リクエストの他の属性の検索を制限します。 近傍（ Proximity ）では、緯度、経度、および半径を使用して検索する円をメートル単位で指定します。 検索方法はに似 mapviewています。 セットエリア内の一致件数が高い順にランク付けされます。 関連するグローバル結果も返されます。

応答データに要素が含まれているコンマ区切りのリスト。

列挙 [performedSearch, matchQuality, matchType, matchCode parsedRequest]

省略形 : [ps, mq, mt, mc, pr]

デフォルトの応答 : matchQuality, matchType

xs: 文字列

xs: 文字列、完全一致

xs: 文字列

xs: boolean

• True - language パラメータで指定された最初の言語で値が使用できる場合、属性値は Address、 Place、 Location 、および Category の各要素で直接設定されます。 代替言語の値が AlternativeValues 要素に返されます。
• False - language パラメーターで指定された言語の優先度に基づいて、 Address、 Place、 Location および Category の各要素で直接使用できる最適な属性値が返されます。 代替案は返されません。

xs: 文字列

一般的に 24 バイトの URL エンコードされた Base64 文字列 ( 保証されていません ) 。 は token 、ユーザーに基づいて生成 app_id され、アプリケーションの登録プロセス後に受信されます。

パラメータ token は廃止されました app_code 。代わりにを使用してください