バージョンをマップします
newest
変数を使用して最新の地図を要求しますhash
値を使用して、世界の特定の地域の異なる地図バージョンを要求します
利用可能なすべての地図バージョンを取得するに は、情報リソースを使用してリクエストを作成します。 応答に map
は、マップのバージョンが要素として region
属性別にグループ化されて一覧表示されます。 応答は、 id
属性がに設定された各リージョンの最新のマップバージョンを示し newest
ます。 次の抜粋は、マップバージョンリストの例を示しています。
<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 時間未満になることがあります。