マップビューリソース
地図リソースは、緯度、経度、またはジオ コーディング(住所ベースの位置検索)、 Reverse ジオ コーディング(住所情報を表示)、および POI (マーカーの有無にかかわらず)に基づいて位置を返します。
マップリソースでは、さまざまなズームレベル、標準、地形、衛星、ハイブリッドなどのマップスキーム、イメージのサイズと形式、スケールバー、ピクチャインピクチャマップがサポートされています。
特定の位置の表現に加えて、対応するジオ座標によって指定された 1 つ以上のジャンル別施設を表示できます。 デフォルトでは、 POI マーカーは特定の場所に表示されますが、マーカーなしで POI 座標を使用して、指定されたすべての場所を含むエリアの地図を表示することもできます。
リソース URI
/?[c=...]
リソースパラメーター
パラメーター | タイプ | 説明 |
---|---|---|
app_id | 文字列 | 通常、 20 バイトの Base64 URL セーフエンコード文字列がクライアント アプリケーションの認証に使用されますが、保証されていません。 アプリ ID/APP コードオプションを使用する場合 は、すべてのリクエストに |
app_code | 文字列 | 通常、 20 バイトの Base64 URL セーフエンコード文字列がクライアント アプリケーションの認証に使用されますが、保証されていません。 アプリ ID/APP コードオプションを使用する場合 は、すべてのリクエストに |
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 が指定されている場合、このパラメータは無視されます。 注 : このパラメータが指定されている場合 、 tx 、tx.xy 、ctr 、ectr 、 注 : このパラメータを指定すると、などのジオ検索パラメータが無視 co されます。 |
C | 地理座標 | 地理座標を配置します。 |
CI | 文字列 | 住所に基づく検索の市区町村名。 UTF-8 でエンコードされ、 URL でエンコードされます。 注 : この機能は廃止されました。 |
CO | 文字列 | 住所に基づく検索の国名。 UTF-8 でエンコードされ、 URL でエンコードされます。 注 : この機能は廃止されました。 |
センター | 地理座標 | 地図の中心点の地理座標です。 位置が地図の境界線にある場合、ドットがクロップされることがあります。 注 : 基本地図 : リクエストに中心点が指定されていない場合 、 POI (パラメータ poi )またはカスタムテキストラベル(パラメータ、tx0 、tx1 など)がリクエストされていない場合、位置パラメータが中心点として使用されます。 中心点パラメーターが指定されている場合は、指定された位置パラメーターよりも優先されます。 このような状況では、要求された位置 ( パラメータ c ) がマップイメージから外れている可能性があります。 パラメータ ectr が指定されているか、 POI ( パラメータ POI) またはカスタムテキストラベル ( パラメータ tx0,tx1,... ) が要求されている場合、このパラメータは無視されます。 地理検索も要求された場合は無視されます。 注 : ルート : これを使用すると、自動的に計算されたルートの中心点が上書きされます これを使用すると、自動計算されたズーム レベルから、フリーのズーム レベル定義を使用できます。つまり、拡大縮小だけでなく、拡大も可能です。 |
E | エンコードされた幾何座標です | 位置のジオ座標パラメーターに相当するエンコード 注 : この機能は廃止されました。 |
選択 | エンコードされた幾何座標です | 地図の中心点の地理座標パラメータと同等の符号化 注 : この機能は廃止されました。 |
F | 整数 | 画像形式。 次の形式でマップイメージを要求できます。
注 : PNG8 画像では、一部のカラーがフルカラー画像と異なる場合があるため、注意して使用してください。 注 : SVG の場合:パラメーター w および h は無視されます。 注 : 道路標識 : PNG 形式のみを使用できます。 注 : CompanyLogo の場合 : PNG および SVG 形式のみを使用できます。 注 : HERE Map Image v1 の今後のバージョンでは、 PNG 、 JPEG 、および PNG8 形式のみがサポートされます。 |
時間 | 整数 | 結果のイメージの高さ ( ピクセル単位 ) 。最大値は 2048 です。 高さと幅のパラメーターは個別に指定できます。つまり、両方を入力してイメージのサイズを変更する必要はありません。 |
私 | ブール型 | 地図画像内の住所または位置の情報ボックスを表示するためのフラグ ( 住所が利用可能な場合、または位置を表示できる場合 ) 。 注 : などのジオ検索パラメータ co が指定されている場合、表示される情報はそれらのパラメータの値に関連付けられます ( 有効な場合 ) 。 注 : この機能は廃止されました。 |
緯度 | 緯度 | 緯度。 経度パラメータとともに使用 lon されます。 注 : 基本地図 : 緯度パラメータは、パラメータまたはを使用して位置を c e 要求した場合には有効になりません。 |
経度 | 経度 | 経度。 緯度 Parameter 緯度とともに使用されます。 注 : 基本地図 : パラメーターを使用した位置 c が要求された場合、経度パラメーターは有効になりません。 |
最大ヒット数 | 整数 | 返される検索結果の最大数。 複数の結果を返す可能性のある種類の検索が実行された場合にのみ適用されます。 1 に設定すると、最初に一致した結果が直接表示され、結果は一覧表示されません。 注 : この機能は廃止されました。 |
ml | 文字列 | 地図のラベル言語。
注 : このドキュメントに記載されている言語は、サーバーの特定の設定によって異なるため、最新ではない可能性があります。 |
ML2 | 文字列 | 二重のラベリングの場合にのみ使用される第 2 言語であるため 地図のラベル言語。
注 : このドキュメントに記載されている言語は、サーバーの特定の設定によって異なるため、最新ではない可能性があります。 |
いいえ | 文字列 | 住所をもとに検索する番地。 注 : この機能は廃止されました。 |
nocmp | フラグ | 地図上でコンパスを非表示にするフラグ。 注 : 画像が 240 未満の場合、コンパスは自動的に非表示になります。 コンパスのサイズは、最終的なマップイメージの幅と高さを決定するために計算されます。 イメージが 240 の場合は 40 、それ以外の場合はイメージのサイズから 100 を引いた 0.1 倍のサイズになります。 注 : この機能は廃止されました。 |
クロップしません | フラグ | 地図上のラベルがトリミングされないようにするフラグ。 要求にパラメータが含まれている場合、要求されたイメージに完全に収まらないラベルはマップに表示されません。パラメータが存在しない場合、デフォルトの動作が適用されます。つまり、ラベルが切り取られても表示されます。 |
いいえ | フラグ | 地図上の著作権情報を非表示にするフラグ。 注 : このパラメータを使用すると、パラメータ scp は無視されます。 |
ドットなし | フラグ | 地図上の位置マーカードットを非表示にするフラグ。 これは、位置が要求された場合にのみ有効です。 |
ノムク | 整数 | 値が設定されていない場合、は地図上の 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 マーカーのラベル付けタイプ。
|
「 Pithm 」 | 整数 | POI マーカーテーマ。
|
poitxc. | 色 | POI マーカーのデフォルトのテキストカラー。 これを使用して、すべての POI マーカーに共通のデフォルトのテキストカラーを定義できます。 デフォルトのテキストカラーが使用できない場合 は、システムデフォルトのホワイトテキストカラーが使用されます。 |
poitxs. | 整数 | POI マーカーのデフォルトのテキストフォントサイズ。有効な範囲は 8 ~ 30 です。 これを使用して、すべての POI マーカーに共通のデフォルトのテキストフォントサイズを定義できます。 デフォルトのテキストフォントサイズを使用できない場合 |
poix0 、 poix1 、 ... | フィールド | 単一の拡張 POI マーカーの特性がフィールドとして表示されます。 指定できるフィールドは次のとおりです ( 次の順序で ) 。
|
PPI | 整数 | 使用する解像度。 以下の 4 つの値のみを使用できます。
注 : このパラメータを使用すると、解像度に合わせてロゴのサイズが調整されます。 注 : モバイルと非モバイルのパラメーターを混在させることはできないため、モバイルのスキームは 250 ppi の値でのみ使用できます。 |
pview | 文字列 | 使用する地政学的ビュー。 このパラメータを使用すると、国際ビューまたはローカルの国ビューに基づいて、境界のあるマップをレンダリングできます。 パラメータを指定しないと、境界のデフォルトのビューになります。 パラメータが指定され、ビューがサポートされている場合は、選択した国のビューの境界が表示されます。 この一覧表には、次のものが含まれますが、これらに限定さ
|
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 | 文字列 | 地図の右下隅に表示されるスケールバー。 スケールバーが画像に正しくフィットしない場合、スケールバーは描画されません。 値は、スケールバーをキロメートル / メートル単位で表示するか、マイル / フィート単位で表示するかを定義します。
注 : スケールバーが画像に正しくフィットしない場合、スケールバーは描画されません。 |
SCP | 文字列 | サービス所有者固有の著作権の ID 。 サービス固有の追加の著作権情報をマップ データの著作権とともに表示します。 値は、事前に設定されたサービス固有の著作権の有効な ID/ キーである必要があります。つまり、パラメータ値自体はマップに表示されません。 注 : フラグパラメータ nocp が要求された場合、このパラメータは無視されます。 サービス固有の著作権は、イメージに適切に適合しない場合は表示されません。 |
スタイル | 文字列 | マップスタイルタイプ。 使用可能なすべてのスタイルは 、 HERE Map Image v1 のマップ ビューサーバーによって定義されます。 この一覧表には、次のものが含まれますが、これらに限定さ
|
T | 整数 | マップ スキームタイプ。 使用可能なすべてのスキームは 、 HERE Map Image v1 API のマップ ビューサーバーによって定義されます。 現在、この API は次のスキームのセットをサポートしています。
|
トークン | 文字列 | 通常、 URL でエンコードされた Base64 文字列ですが、ユーザーのアプリ ID に基づいて 24 バイトが生成され、アプリケーションの登録プロセス後に受信されることは保証されていません。
|
Tx 、 tx0 、 tx1 、 ... | フィールド | カスタムテキスト ( 地図の上に表示されます ) とその特性がフィールドとして表示されます。 テキストには地理的位置に基づいた位置決めが必要です。 地理的な位置情報を使用する場合、他の地理的座標ベースの情報が同時に表示されると、マップのズーム レベルに影響が出ることがあります。
|
tx.xy 、 tx.xy0 、 tx.xy1 、 ... | フィールド | カスタムテキスト ( 地図の上に表示されます ) とその特性がフィールドとして表示されます。 テキストには、画像の XY 座標 ( ピクセル ) ベースの配置 ( ポイント 0,0 が画像の左上隅 ) が必要です。 負の xy 値は、画像の幅と高さの関係値として解釈されます。
tx.xy0 など ) に表示する場合は、テキストパラメータをパラメータ名のインデックスで区別する必要があります tx.xy1 インデックスでは連続した番号付けが必要です。連続した番号付けのギャップがあると、後続のすべてのインデックスパラメータが無視されます。 単一のテキストのみを表示する場合 tx.xy 、パラメーターのインデックス 0 は不要です。つまり、プレーンを使用できます。 注 : 基本地図 : このパラメータを使用すると、パラメータ ctr および ectr は無視されます。 このパラメータ自体は、 POI がパラメータ poi またはで要求された場合には無視 poiN されます( N はインデックス 0..n を意味します)。 注 : ra テキストの座標を使用する場合、テキストは回転されませんので注意してください。 |
TXC | 色 | で定義されたカスタムテキストのデフォルトのテキスト色
|
TXS | 整数 | で定義
|
txsc を使用します | 色 | で定義されたカスタムテキストのデフォルトのテキスト境界線の色
|
U | 距離 | 要求された位置周辺の不確実な領域の半径。
注 : 基本地図 : 表示するには、位置も要求されている必要があります。 |
VT | 整数 | マップ ビュータイプ。
|
W | 整数 | 結果の画像の幅 ( ピクセル単位 ) 。最大値は 2048 です。
注 : Roadsign および CompanyLogo: 最小値は 24 で、最大値は 256 です。 |
Z | 浮動小数 | 地図のズーム レベル。
注 : リクエストにジオ座標リストを持つパラメータ、または単一のジオ座標ペアを値として持つ複数のパラメータが含まれている場合、ズーム レベルが自動的に計算されます。 このような場合、要求されたズーム レベルは、自動的に計算された よりも小さい場合(縮小が必要)にのみ適用されます。 注 : ルート : リクエストにセンターポイント ( ctr または ectr ) も含まれている場合、リクエストされたズーム レベルが常に適用されます。 注 : 5 未満のレベルでは、幅と高さを 1024 以上にすることはできません。 注 : チルト地図の場合 : 5 を超えるズームレベルでは、の上限 h/cos(ta) を 2048 以上にすることはできません。 ズーム レベルは自動的には計算されません。 |
Zi | 文字列 | 住所検索用の郵便番号。 |