セルフホスティング

 HERE Maps API for JavaScript version 3.2

このガイドでは、独自にホストされているアセットとカスタムサービスエンドポイントでHERE Maps API for JavaScriptを実行する方法について説明します。セルフホスティングAPIランタイムファイル、マップスタイルのアセット、サービスURL設定の実際のセットアップフローについて説明します。

このガイドにおけるセルフホスティングとは

このガイドでは、セルフホスティングには以下が含まれます。

  • ドメインからAPIランタイムアセット(JavaScriptモジュールやCSSファイルなど)を提供します。
  • ドメインからスタイルやテーマアセット(スタイル、フォント、スプライトなど)を提供します。
  • 実行時にサービスURLを設定して、APIリクエストを独自のドメインまたはプロキシエンドポイント経由でルート検索します。

このガイドでは、設定と構成に焦点を当てています。セキュリティポリシーの詳細については、「コンテンツセキュリティポリシーを設定する」を参照してください。

1.ホスト型アセットを準備する

APIモジュールのNPMパッケージをダウンロードする

このガイドでは、API JSファイルがNPMで取得され、インフラストラクチャから公開されることを前提としています。

詳細な設定手順については、「HERE Maps API for JavascriptとWebpackおよびRollupをバンドルする」を参照してください。

スタイルアセットNPMパッケージをダウンロードする

上記の手順と同じNPMレジストリ設定を使用してください。まだ設定していない場合は、以下を実行します。

npm config set @here:registry https://repo.platform.here.com/artifactory/api/npm/maps-api-for-javascript/

次に、HERE Maps API for JavaScriptのスタイルアセットパッケージをインストールします。

npm install @here/maps-api-for-javascript-assets

パッケージには以下が含まれます。

@here/maps-api-for-javascript-assets/
├── HERE_NOTICE
├── LICENSE
├── README.md
├── package.json
└── styles/

styles/フォルダーをホストされた場所にコピーし、インフラストラクチャから公開します。

2.ドメインを通じてサービスエンドポイントを設定する

ネットワークポリシーで独自のゲートウェイまたはプロキシ経由のAPIトラフィックが必要な場合は、プラットフォームサービス設定オブジェクトを使用してサービスエンドポイントを設定します。

例:

const servicesConfig = {};
const requestOptions = { apikey: "<YOUR_API_KEY>" };

// HERE Vector Tile API v2
servicesConfig[H.service.omv.Service.CONFIG_KEY] = {
  baseUrl: new H.service.Url(
    "https", "custom.domain", "v2/vectortiles/core/mc", requestOptions
  )
};

// HERE Routing API v8
servicesConfig[H.service.RoutingService8.CONFIG_KEY] = {
  baseUrl: new H.service.Url(
    "https", "custom.domain", "v8/routes", requestOptions
  )
};

const platform = new H.service.Platform({
  apikey: "<YOUR_API_KEY>",
  servicesConfig
});

より広範なサービスリストと例については、「カスタムのドメイン名とサービスパスを設定する」を参照してください。

3.ドメインからマップスタイルの読み込みを設定する

デフォルトレイヤーとカスタムレイヤーのどちらを使用するかに応じて、次のいずれかの方法を使用します。

ユースケース1:セルフホスト型スタイルアセットを含むデフォルトレイヤーを作成する

H.service.Platform.createDefaultLayersを使用する場合は、StyleBaseURLオプションを、セルフホスト型スタイル設定ファイルと関連リソースが保存されているベースURLに設定します。

const defaultLayers = platform.createDefaultLayers({
  styleBaseUrl: "https://<YOUR_ASSET_HOST>/PATH/TO/styles/"
});

const map = new H.Map(
  document.getElementById("mapContainer"),
  defaultLayers.vector.normal.map,
  { center: { lat: 52.531, lng: 13.385 }, zoom: 10 }
);

ユースケース2:セルフホスト型スタイルのJSONファイルでカスタムレイヤーを作成する

カスタムレイヤーを作成する場合は、セルフホスト型スタイル設定のJSONファイルのURLでH.map.render.harp.Styleを初期化します。

const style = new H.map.render.harp.Style(
  "https://<YOUR_ASSET_HOST>/PATH/TO/styles/harp/oslo/normal.day.json"
);

const omvService = platform.getOMVService();
const omvLayer = omvService.createLayer(style);

関連トピック


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