事前定義されたマップフィーチャーを追加する

マップフィーチャーを追加する

HERE SDKでは、マップスキームに加え、MapFeaturesと呼ばれる特殊なレイヤーをサポートしています。これらの機能により、地図に追加データを重ねることができます。

MapFeaturesは、さまざまなMapFeatureModesを設定することで、その視覚的な表示を制御できます。たとえば、3Dランドマークはテクスチャあり、またはテクスチャなしのモードで表示できます。ランドマークは、ほとんどのマップスキームでデフォルトで有効になっています。

各MapSchemeでデフォルトで有効になっているMapFeaturesとMapFeatureModesについては、HERE Style Editorドキュメントの「default features and modes per map scheme」(マップスキームごとのデフォルトの機能とモード) を参照してください。

注

すべてのライセンスですべてのMapFeaturesを使用できるわけではないことに注意してください。「APIリファレンス」を参照して、お使いのライセンスでサポートされているレイヤーを確認してください。

MapFeaturesを追加すると、パフォーマンスに影響を与える可能性があります。

フィーチャー 説明 Explore Navigate
ambientOcclusion 3Dジオメトリー (押出建物とランドマーク) のアンビエントオクルージョン効果。 はい はい
buildingFootprints 建物の2Dフットプリント。 はい はい
congestionZones 渋滞エリア (渋滞課金エリア) として指定されている都市エリアで、当該エリアへの進入には料金が課されます。 はい はい
contours 地図上の等高線を表示または非表示にして、標高の変化を表します。 いいえ はい
environmentalZones 環境ゾーンとしてとして指定されている都市エリアで、当該エリアに進入できる車両の種類が制限されています。 はい はい
extrudedBuildings 建物の簡単な3D表現。 はい はい
landmarks 3Dランドマーク。 いいえ はい
lowSpeedZones 低速ゾーンに指定されている都市エリア。 はい はい
publicTransit 選択したモードに基づき、地下鉄、トラム、電車、モノレール、フェリーなどの公共交通機関の表示を切り替えます。 いいえ はい
roadExitLabels 道路出口ラベルがある場合、ラベルを表示または非表示にします。 はい はい
safetyCameras 安全監視カメラと速度違反取締カメラ。 いいえ はい
shadows すべての建物タイプ (押出建物とランドマーク) の影。 はい はい
terrain 標高地形図を表示します。 いいえ はい
trafficFlow 交通流の速度。 はい はい
trafficIncidents 交通事案。 はい はい
vehicleRestrictions 車両制限。 いいえ はい
trafficLights 信号機。 はい はい

マップフィーチャーレイヤーを有効にする方法を以下に示します。

mapView.mapScene.enableFeatures([MapFeatures.buildingFootprints : MapFeatureModes.buildingFootprintsAll]);
mapView.mapScene.enableFeatures([MapFeatures.contours : MapFeatureModes.contoursAll]); // Only available with the Navigate license.
mapView.mapScene.enableFeatures([MapFeatures.congestionZones : MapFeatureModes.congestionZonesAll]);
mapView.mapScene.enableFeatures([MapFeatures.environmentalZones : MapFeatureModes.environmentalZonesAll]);
mapView.mapScene.enableFeatures([MapFeatures.extrudedBuildings : MapFeatureModes.defaultMode]);
mapView.mapScene.enableFeatures([MapFeatures.landmarks : MapFeatureModes.landmarksTextured]); // Only available with the Navigate license.
mapView.mapScene.enableFeatures([MapFeatures.roadExitLabels : MapFeatureModes.roadExitLabelsAll]); // Only available with the Navigate license.
mapView.mapScene.enableFeatures([MapFeatures.safetyCameras : MapFeatureModes.defaultMode]);
mapView.mapScene.enableFeatures([MapFeatures.shadows : MapFeatureModes.shadowsAll]);
mapView.mapScene.enableFeatures([MapFeatures.terrain : MapFeatureModes.defaultMode]);
mapView.mapScene.enableFeatures([MapFeatures.trafficFlow : MapFeatureModes.defaultMode]); // Only available with the Navigate license.
mapView.mapScene.enableFeatures([MapFeatures.trafficIncidents : MapFeatureModes.defaultMode]);
mapView.mapScene.enableFeatures([MapFeatures.lowSpeedZones : MapFeatureModes.lowSpeedZonesAll]);
mapView.mapScene.enableFeatures([MapFeatures.vehicleRestrictions : MapFeatureModes.defaultMode]); // Only available with the Navigate license.
mapView.mapScene.enableFeatures([MapFeatures.ambientOcclusion : MapFeatureModes.ambientOcclusionAll]);
mapView.mapScene.enableFeatures([MapFeatures.publicTransit : MapFeatureModes.publicTransitAll]); // Only available with the Navigate license.

注

新しいマップシーンが読み込まれると (異なるマップスキーム間で切り替える場合など)、以前に設定されたすべてのマップフィーチャーがデフォルト状態にリセットされます。シーンの読み込み操作を行うたびに、目的のマップフィーチャーを再度有効にする必要があります。

新しいレイヤー状態の設定は同期的に実行されますが、事前読み込み済みの有効なマップシーンが必要です。また、新しいマップシーンの読み込み中に新しいフィーチャー状態を設定すると、例外が発生する場合があります。

同様に、次のようにレイヤーのリストを無効にすることもできます。

mapView.mapScene.disableFeatures([MapFeatures.buildingFootprints,
                                  MapFeatures.extrudedBuildings,
                                  MapFeatures.ambientOcclusion])

注

trafficFlow機能とtrafficIncidents機能が有効になると、HERE SDKは新しいベクタータイルごとに新しいトラフィック情報を要求します。これはたとえば、ビューポートのパンやズームで発生します。このため、計画によってはコストが増加する可能性があります。MapContentSettingsを使用すると、交通流と交通事案の更新期間を調整できますが、ビューポートの変更によって上書きされる可能性があります。ターン・バイ・ターンナビ中はこれが1秒間に複数回発生する可能性があり、トラフィックベクタータイルのリクエストが大量に発生する可能性があります。代替策として、TrafficOnRouteを使用して、ルート沿いの交通情報の表示のみを更新することを検討してください。

各マップフィーチャーは、1つ以上の代替レンダリングオプションをサポートしています。たとえば、terrainのデフォルトモードであるterrainHillshadeを使用する代わりに、terrain3dを使用することで、真の3D地形マップビューで丘陵の地形の陰影を表示できます。

以下に、HERE SDKでサポートされるすべてのマップレイヤーのスクリーンショットを示します。すべてのライセンスですべてのフィーチャーレイヤーが利用できるわけではないことに注意してください。

スクリーンショット (左から右):MapFeatures.buildingFootprintsとMapFeatureModes.buildingFootprintsAllを組み合わせて、建物の2Dフットプリントを表示。MapFeatures.extrudedBuildings と MapFeatureModes.extrudedBuildingsAll を組み合わせて、建物の 3D 表現を表示。MapFeatures.buildingFootprintsとMapFeatures.extrudedBuildingsはデフォルトで有効になっている。無効にしたときの外観。 スクリーンショット (左から右):MapFeatures.landmarksとMapFeatureModes.landmarksTexturedを組み合わせて、テクスチャ付きのランドマークを表示。MapFeatureModes.landmarksTextuelessと組み合わせると、テクスチャなしのランドマークが表示される。MapFeatureModes.landmarksGrayscaleと組み合わせると、ランドマークテクスチャがグレースケールで表示される。 スクリーンショット:MapFeatures.contoursとMapFeatureModes.contoursAllを組み合わせて、地図に高度の変化を示す等高線を表示 (Navigateライセンスでのみ利用可能) スクリーンショット (左から右):MapFeatures.congestionZonesとMapFeatureModes.congestionZonesAllを組み合わせて、渋滞課金ゾーンとして指定された都市部を影付きの紫色で表示 (渋滞課金ゾーンとは、ドライバーが進入または通行する際に料金を支払う必要がある地域です)。MapFeatures.environmentalZonesとMapFeatureModes.environmentalZonesAllを組み合わせて、環境ゾーンとして指定された都市部を影付きの青緑色で表示 (環境ゾーンとは、低二酸化炭素排出量ゾーンとして、特定の車両のアクセスが制限されている都市または地域の指定エリアです)。 スクリーンショット (左から右):MapFeatures.roadExitLabelsとMapFeatureModes.roadExitLabelsNumbersOnlyを組み合わせて、道路出口ラベルを番号で表示。MapFeatureModes.roadExitLabelsAllと組み合わせると、道路出口ラベルがテキストで表示される。 スクリーンショット:MapFeatures.safetyCamerasとMapFeatureModes.safetyCamerasAllを組み合わせて、速度警告カメラを表示。 スクリーンショット:MapFeatures.shadows と MapFeatureModes.shadowsAllを組み合わせて、すべての建物タイプ (建物やランドマーク) の影を表示。 スクリーンショット:MapFeatures.terrainとMapFeatureModes.terrainHillshadeを組み合わせて、丘陵の地形の陰影を表示 (Navigateライセンスでのみ利用可能) スクリーンショット:MapFeatures.terrainとMapFeatureModes.terrain3dを組み合わせて、3D地形マップ上の丘陵の地形の陰影を表示 (Navigateライセンスでのみ利用可能) スクリーンショット (左から右):MapFeatures.trafficFlowとMapFeatureModes.trafficFlowWithFreeFlowを組み合わせて、道路上の現在の交通渋滞を表示。渋滞が発生していない場合は緑色の線で表示される。MapFeatureModes.trafficFlowWithoutFreeFlowと組み合わせると、渋滞が発生していない場合に緑色の線が表示されない。MapFeatureModes.trafficFlowJapanWithoutFreeFlowと組み合わせると、渋滞が発生していない場合に緑色の線が表示されない。 スクリーンショット:MapFeatures.trafficIncidentsとMapFeatureModes.trafficIncidentsAllを組み合わせて、事故や工事などのインシデントを表示。 スクリーンショット (左から右):MapFeatures.vehicleRestrictionsとMapFeatureModes.vehicleRestrictionsActiveを組み合わせて、トラック固有の情報の、アクティブな制約のみを表示。MapFeatureModes.vehicleRestrictionsActiveAndInactiveと組み合わせると、トラック固有の情報の、アクティブおよび非アクティブな時間ベースの制約が表示される。MapFeatureModes.vehicleRestrictionsActiveAndInactiveDifferentiatedと組み合わせると、トラック固有の情報の、アクティブおよび非アクティブな時間ベースの制約が表示されるが、非アクティブな時間ベースの制約は薄く表示される。 スクリーンショット (左から右):左側ではアンビエントオクルージョンが無効になっており、右側ではMapFeatures.ambientOcclusionとMapFeatureModes.ambientOcclusionAllを使用してアンビエントオクルージョンが有効化されており、強調された陰影効果と奥行きのある表現が示されている。 スクリーンショット:MapFeatures.publicTransitとMapFeatureModes.publicTransitAll (Navigateライセンスでのみ利用可能) スクリーンショット:MapFeatures.truckPreferredRoadsとMapFeatureModes.truckPreferredRoadsAll (Navigateライセンスでのみ使用可能) スクリーンショット:MapFeatures.trafficLightsとMapFeatureModes.trafficLightsAll

一部のレイヤーでは、MapContentSettingsを使用して、表示されているコンテンツを絞り込めます。

  • MapFeatures.trafficIncidents:filterTrafficIncidents​(trafficIncidents: [TrafficIncidentType]) を使用して、表示されている交通事案を絞り込めます。
  • MapFeatures.vehicleRestrictions:configureVehicleRestrictionFilter(transportSpecs: transportSpecification) を使用して、表示されているトラックの制約を絞り込めます。

buildingFootprints と extrudedBuildings のマップ レイヤーは、MapView ではデフォルトで有効になっています。

ベータリリース:現在は、昼間、夜間、ハイブリッド昼間、ハイブリッド夜間のマップスキームでもMapFeatureModes.terrain3dをサポートしています。

スクリーンショット (左から右):MapScheme.dayとMapFeatureModes.terrain3d、MapScheme.nightとMapFeatureModes.terrain3d、MapScheme.hybridDayとMapFeatureModes.terrain3d、MapScheme.hybridNightとMapFeatureModes.terrain3d (Navigateライセンスでのみ利用可能)

押出建物のカバレージ

MapFeatures.extrudedBuildings フィーチャーが有効になっている場合、建物はアウトライン付きの 3D でレンダリングされます。建物の外観は国によって異なる場合があります。たとえば、日本ではアウトラインが色付きの建物の壁と組み合わされることがあります。

デフォルトでは、押出建物はほとんどの国でサポートされています。

詳細な日本地図は、別途HEREとの契約が必要となります。

スクリーンショット (左から右):日本以外の地域の押出建物、日本地図の押出建物。

建物の影を有効にする

HERE SDKでは、建物の影のレンダリングがサポートされています。これは、衛星写真ベース以外のマップスキームでのみ使用できます。MapViewの影を有効にするには、以下を使用します。

mapFeatures[MapFeatures.shadows] = MapFeatureModes.shadowsAll

// Sets the desired shadow quality for all instances of MapView.
MapView.shadowQuality = ShadowQuality.veryHigh
mapScene.enableFeatures(mapFeatures)

影品質が設定されていない場合、この機能は効果を持たず、影はレンダリングされません。影を有効にするとパフォーマンスに影響するため、十分な性能を持つデバイスでのみ使用してください。ハードウェア設定でパフォーマンスの問題が発生した場合は、ShadowQualityを下げてください。


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