スタイルを適用する
廃止通知
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です。
利用可能なスタイル
各スタイルは特定のユースケースと視覚的要件に合わせて最適化されています。アプリケーションのニーズ、対象者、環境、データ可視化の優先順位に基づいてスタイルを選択してください。
| スタイル | 料金プラン |
|---|---|
explore.day | Standard |
explore.night | Standard |
explore.satellite.day | Standard |
lite.day | Standard |
lite.night | Standard |
lite.satellite.day | Standard |
logistics.day | Advanced |
logistics.night | Advanced |
logistics.satellite.day | Advanced |
topo.day | Standard |
topo.night | Standard |
satellite.day | Standard |
dem | Standard |
利用可能なスタイルのリストをリクエストする
/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)をサポートします
次のステップ
- マップ要素の制御に関する詳細については、「フィーチャーを制御する」を参照してください。
- サポートされている画像フォーマットとその特性については、「画像フォーマットを選択する」を参照してください。
- HERE Maps API for Javascriptを地図のレンダリングエンジンとして使用しているときにラスターのスタイルを設定する方法の詳細については、「HERE Maps API for Javascriptを使用してラスターマップをレンダリングする」を参照してください。
先月の更新