HERE Map Image v1 開発者ガイド

ルーティングリソース

注 : この機能は廃止されました。

ルーティングリソースは、ルートの計算およびリプレゼンテーションの機能を提供します。ルートマーカーも含めることができ、描画されたルートラインの色と太さをカスタマイズできます。

また、さまざまなマップスキーム、画像サイズ、画像形式、自動計算されたズームレベルからのズームアウトもサポートしています。

表示されている画像のズームレベルは、ルート情報および表示サイズ（幅および高さのパラメータ）を使用して自動的に決定されます。特定のズームレベルは、計算されたよりも小さい場合にのみ考慮され、マップのより広いビューを提供します。

注 : ルーティングリソースには、ルーティングサービスのライセンスも付与されている顧客のみがアクセスできます。

リソース URI

/routing?[f=...]...

リソースパラメーター

パラメーター	タイプ	説明
app_id	文字列	通常、 20 バイトの Base64 URL セーフエンコード文字列がクライアントアプリケーションの認証に使用されますが、保証されていません。アプリ ID/APP コードオプションを使用する場合は、すべてのリクエストに`app_id`と`app_code`を含める必要があります。認証の詳細については、『 Identity & Access Management 開発者ガイド』を参照してください。
app_code	文字列	通常、 20 バイトの Base64 URL セーフエンコード文字列がクライアントアプリケーションの認証に使用されますが、保証されていません。アプリ ID/APP コードオプションを使用する場合は、すべてのリクエストに`app_id`と`app_code`を含める必要があります。認証の詳細については、『 Identity & Access Management 開発者ガイド』を参照してください。
apiKey	文字列	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.
F	整数	画像形式。次の形式でマップイメージを要求できます。 0 個の PNG 1 JPEG ( デフォルト ) 2 種類の GIF 3 BMP 4 PNG8 5 SVG (companylogo のみ ) このオプションを指定しない場合、 JPEG がデフォルトとして使用されます。注 : PNG8 画像では、一部のカラーがフルカラー画像と異なる場合があるため、注意して使用してください。注 : SVG の場合：パラメーター `w` および `h` は無視されます。注 : 道路標識 : PNG 形式のみを使用できます。注 : CompanyLogo の場合 : PNG および SVG 形式のみを使用できます。
時間	整数	結果のイメージの高さ ( ピクセル単位 ) 。最大値は 2048 です。高さと幅のパラメーターは個別に指定できます。つまり、両方を入力してイメージのサイズを変更する必要はありません。
LC 、 lc0 、 lc1 、 ...	色	線の色。 1 つのルートまたはエリア / リージョンのみを提示する場合 `lc` 、パラメータのインデックス 0 は不要です。つまり、プレーンを使用できます。線の色が定義されていない場合は、デフォルトの青い線の色が使用されます。注 : 地域 : 領域 / 領域のアウトラインカラー。 `fc` 対応するインデックスの塗りつぶし色が指定されていない場合にのみ使用されます。つまり、アウトラインと塗りつぶしの色を組み合わせることはできません。一部の領域 / 領域にアウトラインの色が定義されていない場合、対応する領域 / 領域インデックスの塗りつぶしの色が指定されていないと、その領域 / 領域にデフォルトの塗りつぶしの色が使用されます。 `a` パラメーターが指定されていない場合、パラメーターは無視されます。注 : ルート : ルート線の色。インデックスでは連続した番号付けが必要です。連続した番号付けのギャップがあると、後続のすべてのインデックスパラメータが無視され、ギャップの前に最後に使用可能なインデックス線の色パラメータの色が取得されます。注 : 旋削点の場合：これは矢印の線の色です。 `lc` 旋削点ではインデックスなしのパラメーターを使用します。インデックス付け（複数の直線の色）はサポートされていないためです。
lw 、 lw0 、 lw1 、 ...	整数	線幅。 1 つのルートまたはエリア / リージョンのみを提示する場合 `lw` 、パラメータのインデックス 0 は不要です。つまり、プレーンを使用できます。線幅が定義されていない場合は、線幅のデフォルト値である 4 が使用されます。注 : 有効な値は 1 ～ 20 です。注 : 地域 : 領域 / 領域のアウトライン幅。アウトライン幅は、対応するインデックスのアウトラインカラー LC が指定されており、対応するインデックスの塗りつぶしカラー fc が指定されていない場合にのみ使用されます。注 : ルート : ルートラインの幅。インデックスでは連続した番号付けが必要で、連続した番号付けのギャップによって後続のすべてのインデックスパラメータが無視され、これらのパラメータは、ギャップの前にある最後に使用可能なインデックス付きの行幅パラメータの幅を取得します。最終的な線幅は、この線幅と追加の境界線 ( シャドウ ) の線幅で構成されますが ( 線の両側に 1 ピクセル ) 、境界線の色が、同様にインデックス化されたパラメータ SC を使用してルートラインに完全に透明に設定されていない場合に限ります。注 : 旋削点の場合：矢印線の幅。曲線点のインデックスなしのパラメーター LW を使用します。これは、インデックス付け（複数の線幅）がサポートされていないためです。最終的な線幅は、この線幅と追加の境界線 ( シャドウ ) の線幅で構成されます ( 線の両側に 1 ピクセル ) が、パラメータ SC を使用して矢印線の境界線の色が完全に透明に設定されていない場合にのみ使用されます。注 : ルーティングの場合 : 1 つのルートのみがサポートされているため、 1 つの値のみが使用されます。そのため `lw` 、または `lw0` が使用されますが、いずれか 1 つだけが使用されます。指定された値の REST は無視されます。
ml	文字列	地図のラベル言語。マップイメージ内の詳細の説明を表示するために使用する言語を指定します。パラメータが指定されていない場合、デフォルトの言語は、現在サポートされているクライアントの Accept-Language HTTP ヘッダーの優先順位の最も高いロケールに依存します。 HTTP ヘッダーに基づくマップ言語を特定できない場合、サーバで設定されたデフォルトが使用されます。マップ言語がサーバーの設定でロックされている場合、このパラメータ ( または Accept-Language HTTP ヘッダー ) は無効になります。つまり、ロックされたマップ言語が使用されます。次の MARC 3 文字の言語コードが現在サポートされています ( 言語コードでは大文字と小文字が区別されません ) 。 ARA –アラビア料理 Baq –バスク CAT –カタロニア料理 Chi –中華料理 ( シンプル ) CHT –中華料理 ( 伝統料理 ) CZE –チェコ料理 daN –デンマーク料理 DUT –オランダ料理 ENG –英語 FIN –フィンランド料理 fre –フランス料理ドイツ料理のドイツ料理グル–ゲール語 gre –ギリシャ料理 HEB –ヘブライ料理 Hin –ヒンディー料理インドネシア料理 ITA –イタリア料理 NOR –ノルウェー料理パー–ペルシア料理 POL –ポーランド料理 POR –ポルトガル料理ロシア料理 sin –シンハラ語スペイン料理のスパもある SWE –スウェーデン料理 Tha –タイ料理 TUR –トルコ料理 ukr –ウクライナ料理 URD –ウルドゥーヴィ–ベトナム料理 wel –ウェールズ料理言語コードでは大文字と小文字が区別されません。パラメータが指定されていない場合、次のように Accept-Language ヘッダーのロケール値に基づいてマップ言語が選択されます。 EN * 英語 ZH * 中華料理 DE * ドイツ語フランス料理 * IT* イタリア料理 ES* スペイン料理 RU* ロシア料理 ar* アラビア料理注 : このドキュメントに記載されている言語は、サーバーの特定の設定によって異なるため、最新ではない可能性があります。
クロップしません	フラグ	地図上のラベルがトリミングされないようにするフラグ。要求にパラメータが含まれている場合、要求されたイメージに完全に収まらないラベルはマップに表示されません。パラメータが存在しない場合、デフォルトの動作が適用されます。つまり、ラベルが切り取られても表示されます。
いいえ	フラグ	地図上の著作権情報を非表示にするフラグ。注 : このパラメータを使用すると、パラメータ `scp` は無視されます。
POI	地理座標リスト	ジャンル別施設の地理座標のリスト。フラグ `nomrk` が使用されていない場合、ポイントは地図上にマーカーで表示されます。画像に収まらない場合、 POI は常にトリミングされます。塗りつぶしの色 `poifc`( パラメータ ) 、テキストの色 ( パラメータ `poitxc`) 、およびテキストのサイズ ( パラメータ `poitxs`) に共通のデフォルト値を設定することで、マーカーをグループとしてカスタマイズできます。 1 つの POI マーカーごとにカスタマイズする必要がある場合 `poixN` は、拡張 POI パラメータ（ N はインデックス 0 を意味します。 n ）を使用し、すべての POI を個別に単一の拡張 POI として定義する必要があります。注 : 基本地図 : このパラメータを使用すると、パラメータ `ctr, pip` および `txN` (N はインデックス 0..n) が無視されます。 nomrk フラグなしでこのパラメータを使用する場合も、パラメータ i は無視されます。 HTML コンテナが要求された場合（パラメータ HC ） `poixN` 、または拡張 POI （パラメータ N はインデックス 0..n ）を要求した場合、このパラメータ自体は無視されます。注 : ルート : POI マーカーは常に表示されますが、ルートエリアに十分近い場合にのみ表示されます。つまり、 POI マーカーは自動ズームレベル計算または表示されたバウンディングボックスに影響を与えないため、画像から出る可能性があります。注 : このパラメータは、パラメータ`poix`と混合できません。
poifc	色	POI マーカーのデフォルトの塗りつぶし色。これを使用して、すべての POI マーカーに共通のデフォルトの塗りつぶし色を定義できます。デフォルトの塗りつぶし色が使用できない場合は、システムのデフォルトの水色 (0xBF0066AA) の塗りつぶし色が使用されます。
poilbl	整数	POI マーカーのラベル付けタイプ。 0 数値、つまり 1 、 2 、 3 、 ... など（指定されていない場合はデフォルト） 1 アルファベット順（ A 、 B 、 C など）
｢ Pithm ｣	整数	POI マーカーテーマ。 0 ドームカバー 1 ピン 2 HERE スタイルのピン使用できるテーマがない場合は、システムの既定のテーマ 2 （ HERE スタイルのピン）が使用されます。
poitxc.	色	POI マーカーのデフォルトのテキストカラー。これを使用して、すべての POI マーカーに共通のデフォルトのテキストカラーを定義できます。デフォルトのテキストカラーが使用できない場合は、システムデフォルトのホワイトテキストカラーが使用されます。
poitxs.	整数	POI マーカーのデフォルトのテキストフォントサイズ。有効な範囲は 8 ～ 30 です。これを使用して、すべての POI マーカーに共通のデフォルトのテキストフォントサイズを定義できます。デフォルトのテキストフォントサイズを使用できない場合 `10` は、システムデフォルトのテキストフォントサイズが使用されます。
poix0 、 poix1 、 ...	フィールド	単一の拡張 POI マーカーの特性がフィールドとして表示されます。指定できるフィールドは次のとおりです ( 次の順序で ) 。地理座標 ( 必須 ) 地理座標パラメータタイプの形式の緯度および経度。値を指定しない場合、デフォルトが使用されます。塗りつぶし色 ( オプション ) カラーパラメータタイプの形式での POI マーカーの塗りつぶし色。指定されていない場合 `poifc`は、要求されたデフォルトの POI マーカーの塗りつぶし色（パラメーターで定義）が使用されます。デフォルト値が要求されていない場合、システムのデフォルトの POI マーカーの塗りつぶし色が使用されます。テキストの色 ( オプション ) カラーパラメータタイプ形式の POI マーカーテキストの色。指定されていない場合 `poitxc`は、要求されたデフォルトの POI マーカーテキストの色（パラメーターで定義）が使用されます。デフォルト値が要求されていない場合、システムのデフォルトの POI マーカーテキストの色が使用されます。テキストのフォントサイズ ( オプション ) 整数での POI マーカーテキストのフォントサイズ。有効な範囲は 8 ～ 30 です。指定されていない場合 `poitxs`は、要求されたデフォルトの POI マーカーテキストサイズ（パラメーターで定義）が使用されます。デフォルト値が要求されていない場合、システムのデフォルトの POI マーカーテキストフォントサイズが使用されます。カスタムテキスト ( オプション ) POI マーカーのカスタムテキスト。テキストは、まず UTF-8 でエンコードされ、次に URL でエンコードされている必要があります。新しい行は、「 %0D%0A 」または「 %0A 」を使用して URL エンコードで指定できます。テキストにフィールドの区切り文字が含まれている場合は、前にバックスラッシュ '\' を付けてエスケープする必要があります。指定されていない場合 `poilbl`、拡張 POI マーカーには、要求された POI ラベリングタイプ（パラメータなど）に応じて、自動的にアルファベットまたは数値のテキストが表示されます。複数の拡張 POI では、インデックスに連続した番号付けが必要です。連続した番号付けのギャップがあると、後続のすべてのインデックスパラメータが無視されます。ポイントは、フラグ nomrk が使用されていない場合にのみ、マーカー付きで地図に表示されます。重なり合うマーカーは 1 つのマーカーに結合されません。そのため、マーカーは順番に重ねて描画されます。注 : 基本地図 : 拡張 POI パラメータを使用する場合、パラメータ CTR 、 ectr 、 pip 、 TXN （ N はインデックス 0 .. n を意味します）および POI は無視されます。 nomrk フラグなしで拡張 POI パラメータが使用されている場合も、パラメータ I は無視されます。 HTML コンテナが要求さ `hc`れた場合、拡張 POI パラメータ自体は無視されます ( パラメータ ) 。注 : ルート : POI マーカーは常に表示されますが、ルートエリアに十分近い場合にのみ表示されます。つまり、 POI マーカーは自動ズームレベル計算または表示されたバウンディングボックスに影響を与えないため、画像から出る可能性があります。注 : このパラメータはパラメータ POI と混在させることはできません。
PPI	整数	[ 公開 ] 使用する解像度。以下の 4 つの値のみを使用できます。 72 ( デフォルト ) 250 （携帯電話） 320 ( 高解像度 ) 500 無効な値は無視されます。でのみ使用できます T = 0 normal.day T = 2 地形、 1 日 T = 3 ハイブリッドデイ T = 通常の 4 日の輸送 T = 5 normal.day.gray T = 徒歩 13 日 T = 14 名の歩行者用夜間走行注 : このパラメータを使用すると、解像度に合わせてロゴのサイズが調整されます。注 : モバイルと非モバイルのパラメーターを混在させることはできないため、モバイルのスキームは 250 ppi の値でのみ使用できます。
pview	文字列	使用する地政学的ビュー。このパラメータを使用すると、国際ビューまたはローカルの国ビューに基づいて、境界のあるマップをレンダリングできます。パラメータを指定しないと、境界のデフォルトのビューになります。パラメータが指定され、ビューがサポートされている場合は、選択した国のビューの境界が表示されます。この一覧表には、次のものが含まれますが、これらに限定さ arg ( アルゼンチンビュー ) インド ( インド料理 ) マール ( モロッコビュー ) パック ( パキスタンビュー )
Q	整数	1 ～ 100 の範囲の割合でのイメージ圧縮品質。指定しない場合、デフォルトは 85 です。このパラメータは、 JPEG 画像形式が使用されている場合にのみ有効になります。
sc 、 sc0 、 sc1 、 ...	色	シャドウ / 境界の色。注 : 旋削点で `sc` は、矢印の境界色にインデックスのないパラメーターを使用します。注 : ルート : 複数のルートを表示する場合、ボーダーの色はインデックスで区別する必要があります。インデックス番号は、ボーダーの色を同様にインデックス化されたルートにリンクするために使用されます。インデックスでは連続した番号付けが必要で、連続した番号付けのギャップによって後続のすべてのインデックスパラメータが無視され、ギャップの前に最後に使用可能なインデックス付きボーダーの色パラメータの色が取得されます。 1 つのルートのみを提示する場合 `sc` 、パラメーターのインデックス 0 は不要です。つまり、 plain を使用できます。注 : ルーティングの場合 : 1 つのルートのみがサポートされているため、 1 つの値のみが使用されます。そのため `sc` 、または `sc0` が使用されますが、いずれか 1 つだけが使用されます。指定された値の REST は無視されます。
SCP	文字列	サービス所有者固有の著作権の ID 。サービス固有の追加の著作権情報をマップデータの著作権とともに表示します。値は、事前に設定されたサービス固有の著作権の有効な ID/ キーである必要があります。つまり、パラメータ値自体はマップに表示されません。注 : フラグパラメータ `nocp` が要求された場合、このパラメータは無視されます。サービス固有の著作権は、イメージに適切に適合しない場合は表示されません。
スタイル	文字列	マップスタイルタイプ。使用可能なすべてのスタイルは、 HERE Map Image v1 のマップビューサーバーによって定義されます。この一覧表には、次のものが含まれますが、これらに限定さアルプス DAISY DreamWorks 炎運行管理ミニ
T	整数	マップスキームタイプ。使用可能なすべてのスキームは、 HERE Map Image v1 API のマップビューサーバーによって定義されます。現在、この API は次のスキームのセットをサポートしています。 0 （通常の日）昼間灯モードでの通常のマップビュー。 1 （衛星 1 日）衛星マップビュー、昼間灯モード 2 （テレインデイ）昼間灯モードの Terrain マップビュー 3 （ハイブリッドデイ）衛星マップビュー、昼間灯モードの通り沿いにあります。 4 （通常の輸送日数）昼間灯モードで公共交通機関を利用できる、通常の灰色のマップビュー。 5 （ normal.day.gray ）昼間灯モードの通常のグレーのマップビュー ( 背景地図に使用 ) 。 6 （通常の携帯電話）昼間走行モードのスモールスクリーンデバイスの通常のマップビュー。 7 ( 通常の夜間移動 ) 夜間モードの小さな画面デバイスの通常のマップビュー。 8 （ Terrain day.mobile ）昼間灯モードの小型スクリーンデバイス用の Terrain マップビュー。 9 （ハイブリッド、デイ、モバイル）衛星マップビュー。昼間灯モードの小型スクリーンデバイス用道路を備えています。 10 （ normal.day.transit.mobile ）昼間走行モードの小型スクリーンデバイス用の公共交通機関付きの通常の灰色のマップビュー。 11 （ normal.day.gray.mobile ） 12 （ carnav.day.gray ）ナビゲーションデバイス用に設計されたマップビュー。徒歩で 1 日中歩く歩行者のために設計された 13 名のマップビュー。 14 名 ( 徒歩 / 夜間 ) のマップビューは、夜間の歩行者のために設計されています。昼間灯モードの小さな画面デバイスの通常のグレーのマップビュー ( バックグラウンドマップに使用 ) 。デフォルトでは、デイライトモードの通常のマップビュー（ 0 ）が非モバイルクライアントに使用されます。モバイルクライアントの場合、昼間ライトモードのスモールスクリーンデバイスのデフォルトは normal マップビューです（ 6 ）。
トークン	文字列	通常、 URL でエンコードされた Base64 文字列ですが、ユーザーのアプリ ID に基づいて 24 バイトが生成され、アプリケーションの登録プロセス後に受信されることは保証されていません。の使用 `token` は廃止さ `apiKey` れ、代わりに使用する必要があります。
W	整数	結果の画像の幅 ( ピクセル単位 ) 。最大値は 2048 です。高さと幅のパラメーターは個別に指定できます。つまり、両方を入力してイメージのサイズを変更する必要はありません。注 : Roadsign および CompanyLogo: 最小値は 24 で、最大値は 256 です。
waypoint0 、 waypoint1 、 ...	地理座標リスト	経由地座標。パラメータ値は、緯度と経度の座標ペアを表します。これらの経由地は、ルートの計算に使用されます。
Z	浮動小数	地図のズームレベル。使用可能なレベルは、 HERE Map Image v1 API のマップビューサーバによって 0 ～ 20 の値で定義されます。ダフォーズームレベルはです 10。注 : リクエストにジオ座標リストを持つパラメータ、または単一のジオ座標ペアを値として持つ複数のパラメータが含まれている場合、ズームレベルが自動的に計算されます。このような場合、要求されたズームレベルは、自動的に計算されたよりも小さい場合（縮小が必要）にのみ適用されます。注 : ルート : リクエストにセンターポイント (`ctr` または `ectr`) も含まれている場合、リクエストされたズームレベルが常に適用されます。注 : 5 未満のレベルでは、幅と高さを 1024 以上にすることはできません。注 : チルト地図の場合 : 5 を超えるズームレベルでは、の上限 `h/cos(ta)` を 2048 以上にすることはできません。ズームレベルは自動的には計算されません。