HERE Map Image v1 開発者ガイド

地図の画像サイズと形式

HERE Map Image v1 は、デスクトップコンピュータおよびモバイルデバイスで使用されるように設計されています。また、応答内のイメージは、常に利用可能な最新のマップバージョンに基づいています。

マップイメージを要求する場合、イメージサイズまたはイメージ形式を指定する必要はありません。サービスは、クライアント（要求元デバイス）によって送信されたユーザエージェントの HTTP ヘッダーを使用して、応答で生成されたマップイメージのサイズと形式がデバイス表示に最適であることを確認します。ただし、要求で高さ、幅、イメージの形式、またはそのいずれかを指定した場合、サービスはこの情報を考慮し、ユーザエージェントの HTTP ヘッダーに基づいてマップイメージを自動的に生成しません。

たとえば、以下のリクエストは、ヘルシンキ、フィンランドを中心とした画像マップの場合で、画像サイズは指定されません。また、サービスによってサイズと形式が決定される画像が作成されます。

注 : この例では、 HERE API キーを使用して要求を認証します。使用可能な認証オプションについては、『 Identity & Access Management 開発者ガイド』を参照してください。

https://image.maps.ls.hereapi.com/mia/1.6/mapview
?apiKey={YOUR_API_KEY}
&c=60.167,24.883
&u=10k

これとは対照的に、 HERE は追加のパラメータhとwを持つ同様の要求であり、マップイメージの必要な高さと幅を示します。応答として、サービスは、ユーザエージェントの HTTP ヘッダーから自動的に決定される特性を持つイメージではなく、これらのパラメータに一致するイメージを作成します。

https://image.maps.ls.hereapi.com/mia/1.6/mapview
?apiKey={YOUR_API_KEY}
&c=60.167,24.883
&u=10k
&h=300
&w=420

サービスによって返された地図画像には、地球の表面、つまり赤道沿い、北柱と南柱の間の任意の場所の位置のみが表示されます。要求された画像の高さが幅よりも大きい場合、指定したズームレベルの赤道の長さにイメージが及ぶには幅が十分に大きいため、マップイメージの上下に黒いバーが表示されます。これは、 90 度を超える位置や 90 度を下回る位置を表示することはできないためです。

以下のリクエストと写真がこのことを示しています。このリクエストは、フィンランドのヘルシンキを中心にしたズームレベル 1 の地図画像を対象としており、画像の幅は 420 ピクセル、高さは 540 ピクセルに設定されています。

https://image.maps.ls.hereapi.com/mia/1.6/mapview
?apiKey={YOUR_API_KEY}
&c=60.167,24.883
&w=420
&h=540
&z=1