HERE Map Tile v2 開発者ガイド

バージョンをマップします

HERE Map Tile v2 では、使用するマップバージョンを指定するために、次の方法が提供されています。
  • newest 変数を使用して最新の地図を要求します
  • hash 値を使用して、世界の特定の地域の異なる地図バージョンを要求します

利用可能なすべての地図バージョンを取得するに は、情報リソースを使用してリクエストを作成します。 応答に map は、マップのバージョンが要素として region 属性別にグループ化されて一覧表示されます。 応答は、 id 属性がに設定された各リージョンの最新のマップバージョンを示し newestます。 次の抜粋は、マップバージョンリストの例を示しています。

注 : 次の例 では、 HERE API キー を使用して要求を認証します。 使用可能な認証オプションについて は、『 Identity & Access Management 開発者ガイド』を参照してください。
<maps>
<map region="all" id="newest" />
<map region="all" newest="true" id="8.30.53.109" hash="be9b70fa2c" />
</maps>

地図の最新バージョンを使用するには、次の get リクエストを使用します。

https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/11/1202/843/256/png8
?apiKey={YOUR_API_KEY}

特定のマップバージョンを取得するに は、上記be9b70fa2cの例のように、infoリソースに対するリクエストに対する応答からhash属性の値を使用します。 この場合、 GET 要求は次のようになります。

https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/be9b70fa2c/normal.day/11/1202/843/256/png8
?apiKey{YOUR_API_KEY}

hash 特定の地図バージョンを識別する値は、地図 ID が同じであっても、ソフトウェアの更新によって変更される可能性があります。 リクエストに対する有効な応答を取得するに は、常に情報リクエストを最初に作成し、その後のリクエストでマップ タイル (maptile) リソースに現在のマップ hash値を代入します。

トラフィック情報は最新のマップにのみ提供されるため、トラフィックベース URL への要求は常にマップバージョンにnewest使用する必要があります。 例 :

https://2.traffic.maps.ls.hereapi.com/maptile/2.1/traffictile/newest/normal.traffic.day/11/1202/843/256/png8
?apiKey={YOUR_API_KEY}

地図の整合性を維持する

newest プロパティを使用しても整合性は保証されません。 HERE Map Tile v2 への一連のリクエストの間にマップバージョンが更新された場合、異なるマップバージョンの応答を受信することがあります。 これにより、地図の操作に一貫性がなくなる可能性があります。

完全に整合性のあるマップを保証 hash するには、すべてのタイル要求で同じ値を使用します。 hash 値が常に最新の状態に保たれるようにする には、少なくとも 2 時間ごとに情報リソースにリクエストを送信し、最後のリクエスト以降にhash値が変更されたかどうかを確認します。

hash 値で表される各マップバージョンは、一貫したマップエクスペリエンスを保証するために、 24 時間以上サポートされます。 地図またはソフトウェアが正しくない場合、ユーザーの操作性が損なわれる可能性を減らすために、地図またはソフトウェアの有効期限が 24 時間未満になることがあります。