HERE Map Tile 2
メンテナンス中です
HERE Map Tile v2 開発者ガイド

マップ タイル ( マップタイル )

説明

マップ タイルイメージを返します。

形式

このリソースに対するリクエストは、次の式で要約されたパターンに従う必要があります。

https://{1-4}.base.maps.ls.hereapi.com/maptile/2.1/maptile/{map id}/{scheme}/{zoom}/{column}/{row}/{size}/{format}
?apiKey={YOUR_API_KEY}
&{param}={value}
注 : この例 では、 HERE API キー を使用してリクエストを認証します。 使用可能な認証オプションについて は、『 Identity & Access Management 開発者ガイド』を参照してください。

リクエストの作成方法については 、「リクエストの作成」を参照してください

共通の URI パラメータ

次の表に、すべてのリクエストに共通の URI パラメータを示します。

表 1. 共通の URI パラメータ
パラメーター タイプ 説明
列 整数 ( 必須 )

col – 0 ～ number of columns - 1の範囲の任意の数 ( 両方を含む ) を指定できます。

列あたりのタイル数は、ズームの関数です。

number of columns = 2zoom
形式 文字列 ( 必須 ) 画像形式を返しました。 次のイメージ形式がサポートされています。
  • png – PNG 形式、 24 ビット、 RGB
  • png8 – PNG 形式、 8 ビット、インデックスカラー
  • jpg – JPG 形式で 90% の品質

JPG は 、satelliteおよびhybridのスキームにのみお勧めします。

地図 ID 文字列 ( 必須 ) マップのバージョンを newest 、または hash 値で指定します。

「地図のバージョン」も参照してください。

行 整数 ( 必須 )

row – 0 ～ 行数 -1 の範囲の任意の数 ( 両方を含む ) にできます。

行あたりのタイル数は zoom、の関数 number of rows = 2zoom です。
スキーム 文字列 ( 必須 ) ビュースキームを指定します。 サポートされているスキームの完全なリストは 、 Info リソースを使用して取得できます。

注 : スキームとタイルの無効な組み合わせは拒否されることに注意してください。 すべての satellite hybrid terrain およびスキームで 、通常のタイルではなく、航空タイルベースの URL を使用する必要があります。

このhybrid.traffic.dayスキームでは 、通常のタイルではなく、トラフィックタイルベースの URL を使用する必要があります。

トラフィックタイル および マップタイル は、他のトラフィック関連のスキーム（normal.traffic.day、 normal.traffic.night）をサポートしています。 トラフィックタイルからの透過的なトラフィックタイルおよびマップタイルからのベースタイルを要求するトラフィックオーバーレイケースを適切にサポートするため に、マップタイルは、それらをサポートするトラフィックタイルに加えて、これらのスキームもサポートします。

サイズ 整数 ( 必須 ) 画像サイズを返しました。 次のサイズ ([ 幅、高さ ]) がサポートされています。
  • 256 = [256 、 256]
  • 512 =[512, 512]
次のサイズ ([ 幅、高さ ]) は廃止されましたが、引き続き使用できます。
  • 128 =[128, 128]

注 : ラスタカバレッジタイル (rctile、 rconlytile および rcdistonlytile) では、 256 サイズのみがサポートされています。

ズーム 整数 ( 必須 ) マップイメージのズーム レベル。 最小および最大のズームレベルは 、情報 リソースで指定します。

必須のクエリーパラメータです

次の表に、すべてのリクエストで指定する必要がある必須パラメータを示します。 これらのパラメータを指定しないと、システムは要求を拒否します。

表 2. 必須のクエリーパラメータです
パラメーター タイプ 説明
app_id (deprecated)

xs:string

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

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

app_code (deprecated)

xs:string

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

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

apiKey

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 開発者ガイド』を参照してください。

メタデータ固有のクエリーパラメータ（オプション）

表 3. オプションのメタデータクエリーパラメータ
パラメーター タイプ 説明
メタデータ 文字列 生成するメタデータのタイプ。有効な値は次のとおりです。
  • metaonly:メタデータのみが返され、 output=base64 自動的に有効になります
  • 条件なし: 要求されたイメージと関連付けられているメタデータの両方が返され、 output=base64 自動的にオンになります
注 : オプション callback_func で、このパラメータも使用できます。
出力 文字列 値のみを使用 base64できます。この値は、マップ タイルがスタンドアロンイメージではなく、 base64 エンコードテキストとして返されることを示します。
注 : この機能は交通状況に応じてご利用いただけませんので、ご了承ください。
callback_func 文字列 JSON 出力を囲む関数名。 この方法では、 JavaScript を使用して出力をより安全に解析できます。次に例を示します。 
&callback_func=test

戻り値 :

test( [ ... ] );
注 : この値は URL でデコードされますが、要求元は JavaScript の正しい値を提供する責任があります。
フィルタ 文字列 このパラメータには、次の 2 つの値を指定
  • 0 （影響なし）
  • 1 （道路標識のみを除外）
注 : このパラメータ metadata は、応答内の情報のみをフィルタリングします。
注 : このパラメータは、パラメータと組み合わせてのみ使用 mgenできます。
MGEN 文字列 使用するメタデータの生成を指定します。 このパラメータには、次の値を指定できます。
  • 1 ：デフォルト
  • 2: 空の値をフィルタリングしてパラメータの使用を許可する JSON 形式を最適化 filterしました。このバージョンの出力は、開発中のため、リリース間で変更される可能性があります
  • 最新 : 常に利用可能な最新バージョンを使用します
注 : で maptileは、このパラメータは metadata リクエストおよび output JSON でのみ使用できます。
注 : info リクエストの場合、このパラメータは output JSON を使用している場合にのみ使用できます。

オプションのクエリーパラメータ

表 4. オプションのクエリーパラメータ
パラメーター タイプ 説明
渋滞 ブール型

要求されたタイルで輻輳および環境ゾーンの表示をイネーブルにするフラグ（使用可能な場合）。

以下のタイルで使用できます
  • マップタイル
  • 交通量
  • rctile
  • トラックタイル
  • トラックのみ
LG 文字列

特定の言語でレンダリングされたマップ タイルを要求するための MARC 3 文字の言語コード。 指定した言語が使用できない場合 eng は、デフォルトの言語が使用されます。

次の言語がサポートされています。
  • ARA –アラビア料理
  • Baq –バスク
  • CAT –カタロニア料理
  • Chi –中華料理 ( シンプル )
  • CHT –中華料理 ( 伝統料理 )
  • CZE –チェコ料理
  • daN –デンマーク料理
  • DUT –オランダ料理
  • ENG –英語
  • FIN –フィンランド料理
  • fre –フランス料理
  • ドイツ料理のドイツ料理
  • グル–ゲール語
  • gre –ギリシャ料理
  • HEB –ヘブライ料理
  • Hin –ヒンディー料理
  • インドネシア料理
  • ITA –イタリア料理
  • Mul –多言語
  • NOR –ノルウェー料理
  • パー–ペルシア料理
  • POL –ポーランド料理
  • POR –ポルトガル料理
  • ロシア料理
  • sin –シンハラ語
  • スペイン料理のスパもある
  • SWE –スウェーデン料理
  • Tha –タイ料理
  • TUR –トルコ料理
  • ukr –ウクライナ料理
  • URD –ウルドゥー
  • ヴィ–ベトナム料理
  • wel –ウェールズ料理
注 : mul コードを使用する場合は、次の点を考慮する必要があります。
  • 各国は、その国の既定の言語で表示されます。
  • デフォルトの言語では、大陸、国、水域のラベルが表示されます。
LG2 文字列

このパラメータを使用すると、二重ラベルで使用する第 2 言語を指定 lgできます。この言語は、パラメータと同じ動作をします。

次の言語がサポートされています。
  • ARA –アラビア料理
  • Baq –バスク
  • CAT –カタロニア料理
  • Chi –中華料理 ( シンプル )
  • CHT –中華料理 ( 伝統料理 )
  • CZE –チェコ料理
  • daN –デンマーク料理
  • DUT –オランダ料理
  • ENG –英語
  • FIN –フィンランド料理
  • fre –フランス料理
  • ドイツ料理のドイツ料理
  • グル–ゲール語
  • gre –ギリシャ料理
  • HEB –ヘブライ料理
  • Hin –ヒンディー料理
  • インドネシア料理
  • ITA –イタリア料理
  • Mul –多言語
  • NOR –ノルウェー料理
  • パー–ペルシア料理
  • POL –ポーランド料理
  • POR –ポルトガル料理
  • ロシア料理
  • sin –シンハラ語
  • スペイン料理のスパもある
  • SWE –スウェーデン料理
  • Tha –タイ料理
  • TUR –トルコ料理
  • ukr –ウクライナ料理
  • URD –ウルドゥー
  • ヴィ–ベトナム料理
  • wel –ウェールズ料理
POI 文字列 このパラメータは、地図に含まれている POI カテゴリのマスクとして機能します。 ズーム レベルが存在する場合、 POI は 15 以上の に表示されます。存在しない場合は、通常のタイルが表示されます。 マスクの各シンボルは 16 進数で記述されます。 すべてのシンボルが 4 つの POI カテゴリをグループ化 し、最初に使用可能なシンボルグループカテゴリ0-3と最後の 386-389POI カテゴリをグループ化します。 マスクは次のように使用できます。
  • すべて有効 ( デフォルト ): pois
  • すべて無効 : pois=0
  • デフォルトでは無効になっています : pois=F ( 存在するカテゴリのみが有効になり、その他のカテゴリはすべて無効になります )
  • デフォルトで有効 : pois=!F ( 存在するカテゴリのみが無効になり、その他のカテゴリはすべて有効になります )
  • すべてカスタマイズ済み： pois=123.....F （すべての可能な値がマスクに表示されます）
注 : 16 進数では、 0 0-9 ～ 9 の値を表すシンボルと 、 A 、 B 、 C 、 D 、 e 、 F ( または a ～ f)を入力して、 10 ～ 15 の値を表します。
注 : この API を使用できる方法はいくつ かあります。詳細については、 POI フィルタリングの使用状況を確認してください。
注 : 現在 390 の POI カテゴリがありますが 、カテゴリの最新リストを取得する方法については、 /meta/POIs の章を参照してください。
注 : メタ情報タイルで POI 情報を表示する場合は、このパラメータを使用する必要があります。
PPI 整数 1 インチあたりのピクセル数。 リクエスト可能な解決策。有効な値は次のとおりです。
  • 72 –通常。値が指定されていない場合はデフォルトで使用されます
  • 250 台–携帯電話
  • 320 –高解像度
  • 500 ～ 500 ppi

注 : mobile スキームにのみ mobile ppi 値を使用できます。 hi-res スキームに hi-res ppi は値のみを使用できます。 carnav schemesatellite.daynormal.day.customおよびnormal ppiのみ が受け入れられます。

pview 文字列 このパラメータを使用すると、国際ビューまたはローカルの国ビューに基づいて、境界のあるマップをレンダリングできます。 一般的に、地図がローカルビューを利用できる国のいずれかで使用されていない限り、国際ビューを使用する必要があります。 パラメータが指定され、ビューがサポートされている場合は、選択した国のビューの境界が表示されます。 パラメータを指定しないと、境界のデフォルトビューが作成されます。境界とは、メンテナンスなしで従来の目的で保持されているビューのことです。
注 : この API を使用できる方法はいくつ かあります。詳細については、地政学的見解を参照してください。
注 : このサービスで利用できる政治的見解の最新リストを入手する方法については、 /meta/pviews の章を参照してください。
注 : 国際ビューは、常に特別なコードで識別 DEFされます。
注 : メタ情報タイルで、地政学的なビューによって異なる可能性のある情報を表示する場合は、このパラメーターを使用する必要があります。
範囲 文字列 output=base64 がパラメーターrangeとしても指定 されている場合にのみ関連 します。2x23x3または4x4のいずれかである必要があります。またはは、返されたタイルの配列のサイズを示します。 col およびで指定されたタイル row は、アレイの左上にあり、アレイのサイズで除算する必要があります。
スタイル 文字列 タイルのレンダリングに使用するスタイルがある場合は、そのスタイルを選択します。 指定できる値は次のとおりです。
  • 既定値
注 : schemes およびのサブセットのみ tiles がスタイルで使用でき、実行時にチェックされます。 scheme またはtileが指定のstyleで使用できない場合 は、 400 エラーが生成されます。
注 : 特定の顧客およびユースケースについて、他のスタイルが作成されました。 使用可能なスタイルおよびスキームの完全なリストは 、 Info で取得できます。 default スタイルは常に存在します。 このスタイルを URL に追加するか、スタイルパラメータを使用しないと、同じ結果になります。
注 : 運行管理のみがサポート normal.dayします。 hybrid.day and terrain.day
注 : ウィングは normal.day、reduced.day、normal.night 、およびnormal.night.greyのみをサポート します。
注 : DreamWorks のみをサポート normal.dayします。
注 : 炎は normal.day とのみ支持して hybrid.dayいます。
注 : Alps および Mini のみnormal.day,normal.day.grey,normal.day.transit,normal.day.custom,normal.night,normal.night.grey 、 terrain.day,、satellite.day,、hybrid.day,pedestrian.night carnav.day.greyおよびreduced.dayをサポート 。

開発者

製品
コミュニティ
企業情報
プライバシー設定（英語）プライバシーポリシーCookie ポリシーサービス利用規約

©2023 HERE