HERE Map Tile v2 開発者ガイド

正しい地図バージョンを要求しています

HERE Map Tile v2 には次のような特長があり
  • 定期的に地図を更新しました
  • 特定の国の法的要件を満たすために、世界の特定の地域で異なる地図バージョンが使用されています

情報リクエストへの応答 には、属性region ごとにグループ化 された、mapという名前のエレメントとして使用可能なすべてのマップバージョンが一覧表示されます。 応答は、属性 id が値に設定された各リージョンの最新のマップバージョンを示し "newest"ます。 次の抜粋は、マップバージョンリストの例を示しています。

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

マップタイルを要求する場合は、 URL 変数を使用して、最新のマップまたは特定のマップバージョンを示します。

  • newest –利用可能な最新の地図バージョンを要求します。例 :
    https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/11/1202/843/256/png8
    ?apiKey={YOUR_API_KEY}
    トラフィック情報は最新のマップにのみ提供されるため、トラフィックベースの URL への要求は、常にマップバージョンに最新のものを使用する必要があります。 例 :
    https://2.traffic.maps.ls.hereapi.com/maptile/2.1/traffictile/newest/normal.traffic.day/11/1202/843/256/png8
    ?apiKey={YOUR_API_KEY}
  • ハッシュ値–特定のマップバージョンを要求する場合に使用 hash します。実際の URL 変数は、メタデータ要求に対する応答からの属性の値です ( 上記の応答の抜粋を参照 ) 。 たとえば、 HERE は、ではなくハッシュ値を使用するマップ タイル要求 /newest/です。

    マップ ID が同じであっても、ソフトウェアの更新によってマップバージョンを識別するハッシュ値が変更されることに注意してください。 クエリーに対する有効な応答を取得するに は、まずメタデータ要求を作成し、次の URL で現在のマップハッシュ値を c376276c01 に置き換えます。

    https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/c376276c01/normal.day/11/1202/843/256/png8
    ?apiKey={YOUR_API_KEY}
注 : newest を使用 すると、利用可能な最新のマップバージョンが返されますが、整合性は保証されません。 たとえば、一連の要求の間にマップ データで更新がある場合、これらの要求の一部は前のマップからデータを戻し、一部は新しいマップからデータを戻します。そのため、マップのエクスペリエンスに一貫性がなくなる可能性があります。 完全に整合性のあるマップを保証する唯一の方法 は、特定のハッシュコードを使用することです。 同じリクエストを使用するすべてのリクエスト hashcode は、同じリクエストを使用する他のすべてのリクエストと整合 hashcode性が保たれます。 したがって、 hashcode使用上の推奨事項は、トラフィックを除くすべてのタイル要求で常にを使用することです。 使用されているが hashcode 常に最新であることを確認 hashcode するには、少なくとも 2 時間ごとに情報ページを検索し、が以前使用されていたものと比較して変更されているかどうかを確認します。 特定のマップバージョン ()hashcodeは、一貫したマップエクスペリエンスを保証するために、常に 24 時間以上サポートされます。 地図またはソフトウェアに誤りがある場合、ユーザーの操作性の低下を避けるために、有効期間が 24 時間未満になることがあります。
注 : satelliteterrainhybrid すべて traffic のリクエストおよび flow リクエストのトラフィックベース URL およびその他 のリクエストのマップベース URL には、すべてのトラフィックベース URL およびスキームを使用します。
注 : メタデータリクエストは 、ターゲットとするベース URL に固有の情報を取得します。 この情報は、他のベース URL を使用する後続の要求では使用できません。 たとえば、ベース マップバージョンを取得するに は、ベース マップタイルベースの URL にアドレス指定されたリクエストに対する応答からメタデータを使用しますが、アンテナマップのバージョンの場合は、アンテナタイルベースの URL にアドレス指定されたリクエストに対する応答からメタデータを使用します。