HERE Map Image v1 開発者ガイド

マップビューリソース

地図リソースは、緯度、経度、またはジオ コーディング(住所ベースの位置検索)、 Reverse ジオ コーディング(住所情報を表示)、および POI (マーカーの有無にかかわらず)に基づいて位置を返します。

マップリソースでは、さまざまなズームレベル、標準、地形、衛星、ハイブリッドなどのマップスキーム、イメージのサイズと形式、スケールバー、ピクチャインピクチャマップがサポートされています。

特定の位置の表現に加えて、対応するジオ座標によって指定された 1 つ以上のジャンル別施設を表示できます。 デフォルトでは、 POI マーカーは特定の場所に表示されますが、マーカーなしで POI 座標を使用して、指定されたすべての場所を含むエリアの地図を表示することもできます。

リソース URI

/?[c=...]

リソースパラメーター

パラメーター タイプ 説明
app_id 文字列

通常、 20 バイトの Base64 URL セーフエンコード文字列がクライアント アプリケーションの認証に使用されますが、保証されていません。 アプリ ID/APP コードオプションを使用する場合 は、すべてのリクエストにapp_idapp_codeを含める必要があります。 認証の詳細 については、『 Identity & Access Management 開発者ガイド』を参照してください。

app_code 文字列

通常、 20 バイトの Base64 URL セーフエンコード文字列がクライアント アプリケーションの認証に使用されますが、保証されていません。 アプリ ID/APP コードオプションを使用する場合 は、すべてのリクエストにapp_idapp_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.

BBOX 地理座標リスト
任意の数の座標を任意の順序で指定できます。 これらの座標のバウンディング ボックスが作成されます。
注 : poi または poix が指定されている場合、このパラメータは無視されます。
注 : このパラメータが指定されている場合 、txtx.xyctrectr
注 : このパラメータを指定すると、などのジオ検索パラメータが無視 coされます。
C 地理座標

地理座標を配置します。 nodot パラメータが存在しない場合、この位置に位置マーカーのドットが表示されます。 ctrectr、 POI (パラメータ poi)、またはカスタムテキストラベル(パラメータ tx0tx1など)が要求されない場合は、地図の中心点としても使用されます。 パラメータ e が指定されている場合は無視されます 地理検索も要求された場合は無視されます。

CI 文字列

住所に基づく検索の市区町村名。 UTF-8 でエンコードされ、 URL でエンコードされます。

注 : この機能は廃止されました。
CO 文字列

住所に基づく検索の国名。 UTF-8 でエンコードされ、 URL でエンコードされます。

注 : この機能は廃止されました。
センター 地理座標
地図の中心点の地理座標です。 位置が地図の境界線にある場合、ドットがクロップされることがあります。
注 : 基本地図 : リクエストに中心点が指定されていない場合 、 POI (パラメータpoi)またはカスタムテキストラベル(パラメータ、tx0tx1など)がリクエストされていない場合、位置パラメータが中心点として使用されます。 中心点パラメーターが指定されている場合は、指定された位置パラメーターよりも優先されます。 このような状況では、要求された位置 ( パラメータ c) がマップイメージから外れている可能性があります。 パラメータ ectr が指定されているか、 POI ( パラメータ POI) またはカスタムテキストラベル ( パラメータ tx0,tx1,...) が要求されている場合、このパラメータは無視されます。 地理検索も要求された場合は無視されます。
注 : ルート : これを使用すると、自動的に計算されたルートの中心点が上書きされます これを使用すると、自動計算されたズーム レベルから、フリーのズーム レベル定義を使用できます。つまり、拡大縮小だけでなく、拡大も可能です。
E エンコードされた幾何座標です

位置のジオ座標パラメーターに相当するエンコード cされました。 c このパラメータが指定されている場合、パラメータは無視されます。

注 : この機能は廃止されました。
選択 エンコードされた幾何座標です

地図の中心点の地理座標パラメータと同等の符号化 ctrされた値です。 ctr このパラメータが存在する場合、パラメータは無視されます。

注 : この機能は廃止されました。
F 整数
画像形式。 次の形式でマップイメージを要求できます。
  • 0 個の PNG
  • 1 JPEG ( デフォルト )
  • 2 種類の GIF
  • 3 BMP
  • 4 PNG8
  • 5 SVG (companylogo のみ )
このオプションを指定しない場合、 JPEG がデフォルトとして使用されます。
注 : PNG8 画像では、一部のカラーがフルカラー画像と異なる場合があるため、注意して使用してください。
注 : SVG の場合:パラメーター w および h は無視されます。
注 : 道路標識 : PNG 形式のみを使用できます。
注 : CompanyLogo の場合 : PNG および SVG 形式のみを使用できます。
注 : HERE Map Image v1 の今後のバージョンでは、 PNG 、 JPEG 、および PNG8 形式のみがサポートされます。
時間 整数

結果のイメージの高さ ( ピクセル単位 ) 。最大値は 2048 です。 高さと幅のパラメーターは個別に指定できます。つまり、両方を入力してイメージのサイズを変更する必要はありません。

ブール型
地図画像内の住所または位置の情報ボックスを表示するためのフラグ ( 住所が利用可能な場合、または位置を表示できる場合 ) 。
注 : などのジオ検索パラメータ co が指定されている場合、表示される情報はそれらのパラメータの値に関連付けられます ( 有効な場合 ) 。
注 : この機能は廃止されました。
緯度 緯度
緯度。 経度パラメータとともに使用 lonされます。
注 : 基本地図 : 緯度パラメータは、パラメータまたはを使用して位置を ce 要求した場合には有効になりません。
経度 経度
経度。 緯度 Parameter 緯度とともに使用されます。
注 : 基本地図 : パラメーターを使用した位置 c が要求された場合、経度パラメーターは有効になりません。
最大ヒット数 整数

返される検索結果の最大数。 複数の結果を返す可能性のある種類の検索が実行された場合にのみ適用されます。 1 に設定すると、最初に一致した結果が直接表示され、結果は一覧表示されません。

注 : この機能は廃止されました。
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* アラビア料理
注 : このドキュメントに記載されている言語は、サーバーの特定の設定によって異なるため、最新ではない可能性があります。
ML2 文字列

二重のラベリングの場合にのみ使用される第 2 言語であるため 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* アラビア料理
注 : このドキュメントに記載されている言語は、サーバーの特定の設定によって異なるため、最新ではない可能性があります。
いいえ 文字列

住所をもとに検索する番地。

注 : この機能は廃止されました。
nocmp フラグ
地図上でコンパスを非表示にするフラグ。
注 : 画像が 240 未満の場合、コンパスは自動的に非表示になります。 コンパスのサイズは、最終的なマップイメージの幅と高さを決定するために計算されます。 イメージが 240 の場合は 40 、それ以外の場合はイメージのサイズから 100 を引いた 0.1 倍のサイズになります。
注 : この機能は廃止されました。
クロップしません フラグ

地図上のラベルがトリミングされないようにするフラグ。 要求にパラメータが含まれている場合、要求されたイメージに完全に収まらないラベルはマップに表示されません。パラメータが存在しない場合、デフォルトの動作が適用されます。つまり、ラベルが切り取られても表示されます。

いいえ フラグ
地図上の著作権情報を非表示にするフラグ。
注 : このパラメータを使用すると、パラメータ scp は無視されます。
ドットなし フラグ

地図上の位置マーカードットを非表示にするフラグ。 これは、位置が要求された場合にのみ有効です。

ノムク 整数

値が設定されていない場合、は地図上の POI マーカーを非表示にするフラグとして使用されます。 それ以外の場合、入力した値は、画像の枠線に対する POI の周囲のピクセル数のマージンとして使用されます。 これは、パラメータで POI が要求された場合にのみ有効 poiです。 このフラグをと併用 poi すると、表示されているマップに含めるがマーカーは含まない複数のジオコード座標を定義できます。

人身傷害補償 整数
PIP マップのズーム レベルとして指定された値を使用して、マップイメージの右下隅にある実際に要求されたマップと同じ場所にある小さい Picture-in-Picture マップを表示します。 正の値は PIP マップの絶対ズーム レベルとして使用され、負の値はメインマップのズーム レベルからズームアウトするレベル数として解釈されます。 パラメータが指定されているが、パラメータに値が指定されていないか、または有効な値が指定されていない場合、 PIP マップには 5 つのレベルで縮小されたメインマップのズーム レベルが使用されます。 PIP マップのサイズは、要求されたマップサイズ ( マップの幅と高さの 1/3 ) に関連しています。 ただし、 PIP マップの最大サイズは 150 x 150 ピクセルで、最小サイズは 50 x 50 ピクセルです。
注 : PIP ズーム レベルが 3 未満で小数の場合、値は切り捨てられます。
注 : PIP ズーム レベル ( 自動計算または自動指定 ) が地図のズームと同じかそれ以上の場合、緑色の領域は表示されません。
注 : nomrk フラグなしの POI (パラメータ POI )がリクエストされた場合、 PIP-map は表示されません。
注 : このパラメータを ra 使用すると、 PIP-map ズーム レベルが 3 未満の場合、 PIP-map は回転しません。
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 画像形式が使用されている場合にのみ有効になります。

RA 浮動小数点数
0 ~ 360 度の範囲の地図の回転角度です。 指定した角度が 0 の場合、イメージはまったく回転せず、コンパスは表示されません。 角度が 360 より大きいか、 0 より小さい場合、値が正規化されます(例 380 ~ 20 、 -10 ~ 350 )。
注 : このパラメータが要求されていない場合、または値が空または無効な場合 r0は、自動的に北向きになります ( 指定されたルートポイントの最初の 2 つの座標ペアとパラメータによって決定されます ) 。
注 : このパラメータは、ズーム レベルが 3 未満の場合は無効になり、値は無視されます。
注 : 回転後、画像上の POI 、円、カスタムテキスト、その他のアーティファクトが画像の外に出る可能性があります。
注 : この機能は廃止されました。
rad、 rad0 、 rad1 、 ... 距離
エリアの半径。
注 : 基本地図 : 地図の中心点を囲む地図上に表示される周辺エリアの半径。 パラメーター名のインデックス付けはサポート radされていません。つまり、プレーンを使用する必要があります。 ズーム レベルパラメータ z が指定されている場合、またはパラメータが設定された POIs poi( パラメータが設定されている場合 ) またはパラメータが設定されたテキストラベル txN ( ここで、 N はインデックス 0..n) を要求した場合、このパラメータは無視されます。
注 : 地域とヒートマップ : 円形領域の半径。 複数の円形領域 / リージョンを表示する場合、半径はパラメータ名のインデックスで区別する必要があります。 インデックス番号は、 1 つのジオ座標ペアのみを持つ、同様にインデックス化された領域 / リージョンに半径をリンクするために使用されます。 単一の円形領域 / リージョンのみを表示する場合、パラメータのインデックス 0 は不要です。つまり、 plain rad を使用できます。 対応する領域 / 領域のパラメータ AN (N はインデックス 0..n) の値が複数のジオ座標のペアで構成されている ( つまり、正しく定義されていない ) 場合、パラメータは無視されます。 複数の地理座標値を持つことができるため、 1 つの領域 / リージョンのみが存在する場合、この値は適用されません。
s 文字列

住所をもとにした検索の番地。 文字列は、まず UTF-8 でエンコードされてから、 URL でエンコードされている必要があります。

注 : この機能は廃止されました。
SB 文字列
地図の右下隅に表示されるスケールバー。 スケールバーが画像に正しくフィットしない場合、スケールバーは描画されません。 値は、スケールバーをキロメートル / メートル単位で表示するか、マイル / フィート単位で表示するかを定義します。
  • k: スケールバーをキロメートル / メートルで表示します。
  • m: スケールバーをマイル / フィートで表示します。
  • km または mk: キロメートル / メートル、マイル / フィートの 2 つのスケールバーを表示します。
注 : スケールバーが画像に正しくフィットしない場合、スケールバーは描画されません。
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 れ、代わりに使用する必要があります。

Tx 、 tx0 、 tx1 、 ... フィールド
カスタムテキスト ( 地図の上に表示されます ) とその特性がフィールドとして表示されます。 テキストには地理的位置に基づいた位置決めが必要です。 地理的な位置情報を使用する場合、他の地理的座標ベースの情報が同時に表示されると、マップのズーム レベルに影響が出ることがあります。


このパラメータはtx.xyと混合できませ ん。 1 つの
パラメータのみを使用できます。

指定できるフィールドは次のとおりです ( 次の順序で ) 。
  • テキストの場所 ( 必須 )

    地理座標パラメータタイプの形式の緯度および経度。

  • text ( 必須 )

    表示するテキスト。 テキストは、まず UTF-8 でエンコードされ、次に URL でエンコードされている必要があります。 新しい行は、「 %0D%0A 」または「 %0A 」を使用して URL エンコードで指定できます。 テキストにフィールドの区切り文字が含まれている場合は、前にバックスラッシュ '\' を付けてエスケープする必要があります。

  • テキストの色 ( オプション )

    色パラメータータイプ形式のテキストの色。 指定されていない場合 txcは、要求されたデフォルトのテキストの色(パラメーターで定義)が使用されます。 デフォルトが要求されていない場合は、システムのデフォルトのテキストカラーが使用されます。

  • テキストの枠線の色 ( オプション )

    Color パラメータタイプの形式のテキストの枠線の色。 指定されていない場合 txscは、要求されたデフォルトのテキスト境界の色(パラメーターで定義)が使用されます。 デフォルト値が要求されていない場合は、システムのデフォルトのテキスト枠の色が使用されます。

  • テキストのフォントサイズ ( オプション )

    テキストのフォントサイズを整数で指定します。 指定しない txs場合は、要求されたデフォルトのテキストサイズ(パラメータで定義)が使用されます。 default が要求されない場合は、システムのデフォルトのテキストサイズが使用されます。

    緯度 /y 軸の値と経度 /x 軸の値がテキストの中心点になります。 同じマップ上に複数のテキストを表示tx0, tx1 する場合、テキストパラメータはパラメータ名のインデックスで区別する必要があります インデックスでは連続した番号付けが必要です。連続した番号付けのギャップがあると、後続のすべてのインデックスパラメータが無視されます。 単一のテキストのみを表示する場合 tx 、パラメーターのインデックス 0 は不要です。つまり、プレーンを使用できます。

    注 : 基本地図 : このパラメータをジオ座標ベースの情報で使用する場合、つまり、 .xy を使用しない場合 ctr 、パラメータおよび ectr は無視されます。 このパラメータ自体は、 POI がパラメータ poi または( poiN N はインデックス 0..n )で要求され、 NO nomrk が使用されている場合は無視されます。
    注 : ra テキストの座標を使用する場合は xy 、が使用されていない限り回転されます。その場合は回転されません。
tx.xy 、 tx.xy0 、 tx.xy1 、 ... フィールド
カスタムテキスト ( 地図の上に表示されます ) とその特性がフィールドとして表示されます。 テキストには、画像の XY 座標 ( ピクセル ) ベースの配置 ( ポイント 0,0 が画像の左上隅 ) が必要です。 負の xy 値は、画像の幅と高さの関係値として解釈されます。


このパラメータは tx,tx0,tx1 、 1 つのパラメータとのみ混合することはできません。

指定できるフィールドは次のとおりです ( 次の順序で ) 。
  • テキストの位置 ( 必須 ) 経度および緯度 ( ピクセルベースの xy 座標値 ) 。 ピクセルベースの値は、接頭辞 'xy.' を使用して定義し、 x 軸の値を整数 ( イメージの幅とイメージの幅の間に負 ) で、 y 軸の値を整数 ( イメージの高さとイメージの高さの間に負 ) でコンマ ',' で区切って指定します。
  • 表示するテキスト ( 必須 ) 。 テキストは、まず UTF-8 でエンコードされ、次に URL でエンコードされている必要があります。 新しい行は、「 %0D%0A 」または「 %0A 」を使用して URL エンコードで指定できます。 テキストにフィールドの区切り文字が含まれている場合は、前にバックスラッシュ '\' を付けてエスケープする必要があります。
  • テキストの色 ( オプション ) 色パラメータタイプの形式のテキストの色 指定されていない場合 txcは、要求されたデフォルトのテキストの色(パラメーターで定義)が使用されます。 デフォルトが要求されていない場合は、システムのデフォルトのテキストカラーが使用されます。
  • テキストの枠線の色 ( オプション ) Color パラメータタイプの形式のテキストの枠線の色です。 指定されていない場合 txscは、要求されたデフォルトのテキスト境界の色(パラメーターで定義)が使用されます。 デフォルト値が要求されていない場合は、システムのデフォルトのテキスト枠の色が使用されます。
  • テキストフォントサイズ ( オプション ) 整数でのテキストフォントサイズ。 指定しない txs場合は、要求されたデフォルトのテキストサイズ(パラメータで定義)が使用されます。 default が要求されない場合は、システムのデフォルトのテキストサイズが使用されます。
緯度 /y 軸の値と経度 /x 軸の値がテキストの中心点になります。 複数のテキストを同じマップ ( tx.xy0など ) に表示する場合は、テキストパラメータをパラメータ名のインデックスで区別する必要があります tx.xy1 インデックスでは連続した番号付けが必要です。連続した番号付けのギャップがあると、後続のすべてのインデックスパラメータが無視されます。 単一のテキストのみを表示する場合 tx.xy 、パラメーターのインデックス 0 は不要です。つまり、プレーンを使用できます。
注 : 基本地図 : このパラメータを使用すると、パラメータ ctr および ectr は無視されます。 このパラメータ自体は、 POI がパラメータ poi またはで要求された場合には無視 poiN されます( N はインデックス 0..n を意味します)。
注 : ra テキストの座標を使用する場合、テキストは回転されませんので注意してください。
TXC

で定義されたカスタムテキストのデフォルトのテキスト色 txN です (N はインデックス 0..n を意味します ) 。


これを使用して、すべてのカスタムテキストに共通の既定のテキストの色を定義できます。
デフォルトのテキストカラーが使用できない場合は、システムのデフォルトのテキストカラーが使用されます。

TXS 整数

で定義 txN されたカスタムテキストのデフォルトのテキストフォントサイズ (N はインデックス 0..n) 。


これを使用して、すべてのカスタムテキストに共通の既定のテキストフォントサイズを定義できます。
デフォルトのテキストフォントサイズを使用できない場合は、システムデフォルトのテキストフォントサイズが使用されます。

txsc を使用します

で定義されたカスタムテキストのデフォルトのテキスト境界線の色 txN です (N はインデックス 0..n を意味します ) 。


これを使用して、すべてのカスタムテキストに共通の既定のテキスト枠線の色を定義できます。
デフォルトのテキスト枠の色が使用できない場合は、システムのデフォルトのテキスト枠の色が使用されます。

U 距離
要求された位置周辺の不確実な領域の半径。


位置マーカードットの周囲に半径として指定した値を持つカラーで塗りつぶされた円を描画します。

注 : 基本地図 : 表示するには、位置も要求されている必要があります。
VT 整数
マップ ビュータイプ。
  • 0

    通常のマップ ビュー。

  • 1

    公共交通機関情報のない通常のマップ ビュー。

  • 2

    公共交通機関情報のない Traffic マップ ビュー。

W 整数
結果の画像の幅 ( ピクセル単位 ) 。最大値は 2048 です。


高さと幅のパラメーターは個別に指定
できます。つまり、両方を入力してイメージのサイズを変更する必要はありません。

注 : Roadsign および CompanyLogo: 最小値は 24 で、最大値は 256 です。
Z 浮動小数
地図のズーム レベル。


使用可能なレベルは 、 HERE Map Image v1 API のマップ ビューサーバによって 0 ~ 20 の値で定義されます。 ダフォーズーム レベルはです 10

注 : リクエストにジオ座標リストを持つパラメータ、または単一のジオ座標ペアを値として持つ複数のパラメータが含まれている場合、ズーム レベルが自動的に計算されます。 このような場合、要求されたズーム レベルは、自動的に計算された よりも小さい場合(縮小が必要)にのみ適用されます。
注 : ルート : リクエストにセンターポイント (ctr または ectr) も含まれている場合、リクエストされたズーム レベルが常に適用されます。
注 : 5 未満のレベルでは、幅と高さを 1024 以上にすることはできません。
注 : チルト地図の場合 : 5 を超えるズームレベルでは、の上限 h/cos(ta) を 2048 以上にすることはできません。 ズーム レベルは自動的には計算されません。
Zi 文字列

住所検索用の郵便番号。