スタイルを適用する

⚠️

廃止通知

PNGおよびPNG8の画像フォーマットは、HERE Raster Tile API内のすべての衛星ベーススタイルで廃止となります。この変更は、satellite.day、explore.satellite.day、lite.satellite.day、logistics.satellite.dayを含む衛星画像を使用するスタイルに特に関連します。

この廃止は、リソースパラメーターがbaseまたはbackgroundに設定されている場合に適用されます。これらのシナリオでは、PNGまたはPNG8の代わりにJPEG形式を使用してください。2026年9月より、PNG/PNG8を指定したリクエストは即座には失敗しないものの、サービスによって自動的にJPEG形式で圧縮されたタイルが返されます。

styleパラメーターを使用すると、マップタイルの見た目や強調するコンテンツを制御できます。

HERE Raster Tile APIは、さまざまなアプリケーションタイプやユーザーニーズに適した多様なスタイルを提供しています。以下のリストは、各スタイルカテゴリーに適したシナリオの例です。

  • ナビゲーションアプリ - 明確な道路ネットワークを表示する汎用地図にexploreスタイルを使用する
  • データのビジュアル化 - liteスタイルを適用して、カスタムデータを重ねた際の視覚的なノイズを減らす
  • 物流プラットフォーム - logisticsスタイルでトラック輸送に最適化された道路と制限を表示する
  • アウトドアアクティビティ - topoスタイルを使用して、ハイキングやサイクリング向けに標高と地形を表示する
  • ダークモードアプリ - 低照度環境向けにnightスタイルに切り替える

スタイルパラメーターを指定しない場合のデフォルトスタイルはexplore.dayです。

利用可能なスタイル

各スタイルは特定のユースケースと視覚的要件に合わせて最適化されています。アプリケーションのニーズ、対象者、環境、データ可視化の優先順位に基づいてスタイルを選択してください。

利用可能なスタイルのリストをリクエストする

/infoエンドポイントを使用して利用可能なスタイルをクエリできます:

GET https://maps.hereapi.com/v3/info?apiKey={YOUR_API_KEY}

レスポンス例:

"styles": [
  "dem",
  "explore.day",
  "explore.night",
  "explore.satellite.day",
  "lite.day",
  "lite.night",
  "lite.satellite.day",
  "logistics.day",
  "logistics.night",
  "logistics.satellite.day",
  "satellite.day",
  "topo.day",
  "topo.night"
]
📘

注

You can cache this list in your application and refresh every 24 hours.

例

以下は、利用可能な各スタイルオプションの外観の例です。同じ地理的位置とズームレベルのマップリクエストのサンプルと、それによって生成されたタイルの例を紹介しています。スタイルを変えることで同じマップデータがどのように表示されるかを比較できます。

explore.day (デフォルト)

このスタイルを使用すると、すべての主要なフィーチャーを表示する、バランスの取れた詳細度の汎用的な地図を作成できます(デフォルト)。サンプルリクエスト:

GET https://maps.hereapi.com/v3/base/mc/13/4347/2917/png?apiKey={YOUR_API_KEY}&size=512

lite.day

カスタムデータや分析をオーバーレイするアプリケーション向けにデザインされたミニマルなスタイルです。サンプルリクエスト:

GET https://maps.hereapi.com/v3/base/mc/13/4347/2917/png?style=lite.day&apiKey={YOUR_API_KEY}&size=512

logistics.day

トラックに最適化された道路、ルーティングコリドー、物流関連の制限の表示の強化に特化したスタイルです。サンプルリクエスト:

GET https://maps.hereapi.com/v3/base/mc/13/4347/2917/png?style=logistics.day&apiKey={YOUR_API_KEY}&size=512

topo.day

標高、等高線、地形を強調した地形図スタイルです。サンプルリクエスト:

GET https://maps.hereapi.com/v3/base/mc/13/4347/2917/png?style=topo.day&apiKey={YOUR_API_KEY}&size=512

logistics.night

トラックのルートと商用ナビゲーションに重点を置いた、夜間の物流業務向けスタイルです。サンプルリクエスト:

GET https://maps.hereapi.com/v3/base/mc/13/4347/2917/png?style=logistics.night&apiKey={YOUR_API_KEY}&size=512

explore.night

夜間に視認性を高めるためにハイコントラストの要素を使用した、低光量環境に最適化された地図向けのスタイルです。サンプルリクエスト:

GET https://maps.hereapi.com/v3/base/mc/13/4347/2917/png?style=explore.night&apiKey={YOUR_API_KEY}&size=512

explore.satellite.day

衛星画像に重ね合わせた汎用地図のスタイルで、豊富な視覚的情報を提供します。サンプルリクエスト:

GET https://maps.hereapi.com/v3/base/mc/13/4347/2917/jpeg?style=explore.satellite.day&apiKey={YOUR_API_KEY}&size=512

lite.night

夜間の使用に最適化されたミニマルなスタイルで、低光量の環境でのカスタムデータオーバーレイに適しています。サンプルリクエスト:

GET https://maps.hereapi.com/v3/base/mc/13/4347/2917/png?style=lite.night&apiKey={YOUR_API_KEY}&size=512

lite.satellite.day

衛星画像背景にデータを重ね合わせるアプリケーション向けの、ミニマルな衛星画像ベースのスタイルです。サンプルリクエスト:

GET https://maps.hereapi.com/v3/base/mc/13/4347/2917/jpeg?style=lite.satellite.day&apiKey={YOUR_API_KEY}&size=512

logistics.satellite.day

物流に最適化されたスタイルで、運行管理業務における地理的コンテキストを提供する衛星画像背景を使用しています。サンプルリクエスト:

GET https://maps.hereapi.com/v3/base/mc/13/4347/2917/jpeg?style=logistics.satellite.day&apiKey={YOUR_API_KEY}&size=512

topo.night

暗い場所での閲覧向けの視認性を備えた、標高と地形を示す夜間用地形図スタイルです。サンプルリクエスト:

GET https://maps.hereapi.com/v3/base/mc/13/4347/2917/png?style=topo.night&apiKey={YOUR_API_KEY}&size=512

satellite.day

地図のオーバーレイやラベルのない純粋な衛星画像です。サンプルリクエスト:

GET https://maps.hereapi.com/v3/base/mc/13/4347/2917/jpeg?style=satellite.day&apiKey={YOUR_API_KEY}&size=512

DEM

数値標高モデル(dem)スタイルは、エンコードされた高さの値のグリッドを使用して、地表面を3Dで表現します。

demスタイルの重要な点は次のとおりです。

  • DEMスタイルでは、標高データがPNG形式で保存されます (PNG8形式はサポートされていません)。

  • このスタイルは人間が直接使用するためではなく、クライアント側のレンダリングエンジン (Webブラウザーなど) によって、現実世界の光を再現するシェーディング効果など、インタラクティブで見た目が魅力的な3D地形マップを作成する目的で設計されています。

  • DEMタイルには、隣接するタイルからのパディングやオーバーラップは含まれません。この情報が必要な場合 (3Dメッシュを作成する場合など) は、隣接するタイルをロードしてそのデータをコピーすることで取得できます。

  • このスタイルでは、PNG形式の8ビットRGBカラーチャネルを使用して標高データをエンコードします。

    対応する高さの値をメートル単位で計算するには、次の式を適用します。

    height = -10000 + ((R * 256 * 256 + G * 256 + B) * 0.1)

    R、G、Bはピクセルの赤、緑、青のチャネルをそれぞれ表します。

📘

注

demスタイルで表される高さの値は海抜高度で、ジオイド面 (平均海面に相当する理論上の面) からの高さを示します。

以下のリクエストは、DEMタイルを取得する方法を示しています。

GET https://maps.hereapi.com/v3/base/mc/13/4347/2917/png?style=dem&apiKey={YOUR_API_KEY}&size=512
📘

注

demスタイルにはPNG形式を使用する必要があり、size=256 (デフォルト)またはsize=512 (scale=1)をサポートします

次のステップ


このページは役に立ちましたか?