Render - Get Map Static Image

string

Azure Maps API のバージョン番号。 現在のバージョンは 2024-04-01 です。

number[]

境界ボックスは、地球上の四角形領域の 4 辺を表す 2 つの緯度と 2 つの経度によって定義されます。 形式: 'minLon、minLat、maxLon、maxLat' (double)。

注: bbox または center は必須パラメーターです。 これらは相互に排他的です。 bbox は、高さまたは幅で使用しないでください。

Lat と Lon に許可される最大範囲と最小範囲は、このページの上部にあるテーブルのズーム レベルごとに定義されます。

number[]

中心点の座標を倍精度浮動小数点型 (double) で指定します。 形式: 'lon,lat' 経度の範囲: -180 から 180。 緯度の範囲: -90 から 90。

注: center または bbox は必須パラメーターです。 これらは相互に排他的です。

integer

結果の画像の高さ (ピクセル単位)。 範囲は 80 から 1500 です。 既定値は 512 です。 bbox では使用しないでください。

string

検索結果を返す言語。 サポートされている IETF 言語タグの 1 つである必要があります。大文字と小文字は区別されません。 指定した言語のデータが特定のフィールドで使用できない場合は、既定の言語が使用されます。

詳細については、「 サポートされている言語 」を参照してください。

string[]

パスのスタイルと場所 (double)。 必要に応じて、線、多角形、または円を画像に追加するには、このパラメーターを使用します。 パス スタイルは、線と塗りつぶしの外観を表します。 (パイプや句読点などの予約文字が含まれるため、このパラメーターの値を正しく URL エンコードしてください)。

Path パラメーターは、S1 以降の Azure Maps アカウント SKU でサポートされています。 path パラメーターの複数のインスタンスを使用すると、スタイルを使用して複数のジオメトリを指定できます。 要求あたりのパラメーターの数は 10 に制限され、場所の数はパスあたり 100 に制限されます。

既定のスタイルを使用して緯度 45°N と経度 122°W で半径 100 メートルと中心点を持つ円をレンダリングするには、querystring パラメーターを追加します。

path=ra100||-122 45

経度は緯度より前に来る点に注意してください。 URL エンコードの後、これは次のようになります

path=ra100%7C%7C-122+45

ここでのすべての例では、わかりやすくするために、URL エンコードなしの path パラメーターを示します。

線をレンダリングするには、各位置をパイプ文字で区切ります。 たとえば、次を使用します。

path=||-122 45|-119.5 43.2|-121.67 47.12

多角形は、最初と最後の点が等しい閉じたパスで指定されます。 たとえば、次を使用します。

path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45

線とポリゴンの位置の経度値は、-360 ~ 360 の範囲に設定して、子午線を横切るジオメトリをレンダリングできます。

スタイル修飾子

スタイル修飾子を追加することで、パスの外観を変更できます。 これらは、場所の前に追加されます。 スタイル修飾子はそれぞれ 2 文字の名前を持ちます。 これらの省略名は、URL の長さを短くするために使用されます。

アウトラインの色を変更するには、'lc' スタイル修飾子を使用し、6 桁の 16 進数である HTML/CSS RGB カラー形式を使用して色を指定します (3 桁の形式はサポートされていません)。 たとえば、CSS で #FF1493 として指定する濃いピンク色を使用するには、

path=lcFF1493||-122 45|-119.5 43.2

複数のスタイル修飾子を組み合わせて、より複雑なビジュアル スタイルを作成できます。

lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6

スタイル修飾子の概要

string[]

プッシュピン のスタイルとインスタンス。 このパラメーターを使用して、必要に応じてイメージに画鄒を追加します。 プッシュピン スタイルは、プッシュピンの外観を表し、インスタンスは各ピンのプッシュピンの座標 (double) と省略可能なラベルを指定します。 (パイプや句読点などの予約文字が含まれるため、このパラメーターの値を正しく URL エンコードしてください)。

Azure Maps アカウント S0 SKU では、pin パラメーターの 1 つのインスタンスのみがサポートされます。 その他の SKU を使用すると、pin パラメーターの複数のインスタンスで複数のピン スタイルを指定できます。

既定の組み込みのプッシュピン スタイルを使用して緯度 45°N と経度 122°W でプッシュピンをレンダリングするには、querystring パラメーターを追加します

pins=default||-122 45

経度は緯度より前に来る点に注意してください。 URL エンコードの後、これは次のようになります

pins=default%7C%7C-122+45

ここでの例はすべて、わかりやすくするために、URL エンコードなしの pin パラメーターを示しています。

複数の場所にピンをレンダリングするには、各位置をパイプ文字で区切ります。 たとえば、次を使用します。

pins=default||-122 45|-119.5 43.2|-121.67 47.12

S0 Azure Maps アカウント SKU では、5 つのプッシュピンのみが許可されます。 他のアカウント SKU には、この制限はありません。

スタイル修飾子

ピンの外観を変更するには、スタイル修飾子を追加します。 これらは、スタイルの後、場所とラベルの前に追加されます。 スタイル修飾子はそれぞれ 2 文字の名前を持ちます。 これらの省略名は、URL の長さを短くするために使用されます。

プッシュピンの色を変更するには、'co' スタイル修飾子を使用し、6 桁の 16 進数である HTML/CSS RGB カラー形式を使用して色を指定します (3 桁の形式はサポートされていません)。 たとえば、CSS で #FF1493 として指定する濃いピンク色を使用するには、

pins=default|coFF1493||-122 45

画鄒ラベル

ピンにラベルを追加するには、座標の直前にラベルを単一引用符で囲みます。 ラベルに や || などの|特殊文字を使用しないでください。 たとえば、3 つのピンに値 '1'、'2'、および '3' のラベルを付ける場合は、

pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

"none" という組み込みのプッシュピン スタイルがあり、プッシュピン イメージは表示されません。 これは、ピン 画像なしでラベルを表示する場合に使用できます。 たとえば、オブジェクトに適用された

pins=none||'A'-122 45|'B'-119.5 43.2

プッシュピン ラベルの色を変更するには、'lc' ラベルの色スタイル修飾子を使用します。 たとえば、ピンクのプッシュピンと黒いラベルを使用するには、

pins=default|coFF1493|lc000000||-122 45

ラベルのサイズを変更するには、'ls' ラベル サイズ スタイル修飾子を使用します。 ラベル サイズは、ラベル テキストのおおよその高さをピクセル単位で表します。 たとえば、ラベル サイズを 12 に増やすには、

pins=default|ls12||'A'-122 45|'B'-119 43

ラベルは、画鋲 'label anchor' の中央に配置されます。 アンカーの場所は、組み込みのプッシュピン用に事前に定義されており、カスタム プッシュピンの上部中央にあります (下記参照)。 ラベル アンカーをオーバーライドするには、'la' スタイル修飾子を使用し、アンカーの X と Y のピクセル座標を指定します。 これらの座標は、画鄒画像の左上隅を基準にしています。 正の X 値を指定するとアンカーが右に移動し、正の Y 値を指定するとアンカーが下方向に移動します。 たとえば、ラベル アンカーを右に 10 ピクセル、画鋲画像の左上隅の 4 ピクセル上に配置するには、

pins=default|la10 -4||'A'-122 45|'B'-119 43

カスタム プッシュピン

カスタム プッシュピン イメージを使用するには、ピン スタイル名として "custom" という単語を使用し、場所とラベル情報の後に URL を指定します。 カスタマイズされたラベル イメージの最大許容サイズは 65,536 ピクセルです。 2 つのパイプ文字を使用して、場所の指定が完了し、URL を開始していることを示します。 たとえば、オブジェクトに適用された

pins=custom||-122 45||http://contoso.com/pushpins/red.png

URL エンコードの後、これは次のようになります

pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png

既定では、カスタム プッシュピンイメージはピン座標の中央に描画されます。 これは通常、強調表示しようとしている場所が隠れているため、理想的ではありません。 ピン イメージのアンカー位置をオーバーライドするには、'an' スタイル修飾子を使用します。 これは、'la' ラベル アンカー スタイル修飾子と同じ形式を使用します。 たとえば、カスタムピンイメージの左上隅にピンの先端がある場合は、 を使用してアンカーをそのスポットに設定できます。

pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png

注: カスタム プッシュピン イメージで "co" 色修飾子を使用する場合、指定した色はイメージ内のピクセルの RGB チャネルを置き換えますが、アルファ (不透明度) チャネルは変更されません。 これは通常、単色のカスタム イメージでのみ行われます。

スケール、回転、不透明度

'sc' スケール スタイル修飾子を使用して、プッシュピンとそのラベルを大きくまたは小さくすることができます。 これは 0 より大きい値です。 1 の値が標準のスケールです。 1 より大きい値にするとピンが大きくなり、1 より小さい値にすると小さくなります。 たとえば、通常よりも 50% 大きい画鍖を描画するには、

pins=default|sc1.5||-122 45

'ro' 回転スタイル修飾子を使用して、プッシュピンとそのラベルを回転させることができます。 これは時計回りの回転の角度です。 負の数値を使用して反時計回りに回転します。 たとえば、プッシュピンを時計回りに 90 度回転し、そのサイズを 2 倍にするには、

pins=default|ro90|sc2||-122 45

'al' アルファ スタイル修飾子を指定することで、プッシュピンとそのラベルを部分的に透明にすることができます。 これは、画鄁の不透明度を示す 0 ~ 1 の間の数値です。 ゼロを指定すると、完全に透明になり (表示されません)、1 は完全に不透明になります (既定値)。 たとえば、プッシュピンとそのラベルを 67% だけ不透明にするには、

pins=default|al.67||-122 45

スタイル修飾子の概要

• X 座標と Y 座標は、ピン 画像内の任意の場所、またはその周囲の余白にすることができます。 余白のサイズは、ピンの幅と高さの最小値です。

TilesetId

返されるマップ スタイル。 指定できる値は、microsoft.base.road、microsoft.base.darkgrey、microsoft.imagery です。 既定値は microsoft.base.road に設定されています。 詳細については、「 Render TilesetId」を参照してください。

TrafficTilesetId

オプションの値。画像の結果にトラフィック フローがオーバーレイされていないことを示します。 指定できる値は microsoft.traffic.relative.main で、なしです。 既定値は none で、トラフィック フローが返されていないことを示します。 トラフィック関連の tilesetId が指定されている場合、対応するトラフィック レイヤーを持つマップ イメージが返されます。 詳細については、「 Render TilesetId」を参照してください。

LocalizedMapView

View パラメーター ("user region" パラメーターとも呼ばれます) を使用すると、地政学的に紛争が発生している地域の特定の国/地域の正しいマップを表示できます。 このようなリージョンのビューは国や地域によって異なります。また、View パラメーターを使用すると、アプリケーションがサービスを提供する国/地域に必要なビューにアプリケーションを準拠できます。 既定では、View パラメーターは、要求で定義していない場合でも "Unified" に設定されます。 ユーザーの場所を特定し、その場所を正しく View パラメーターを設定するのはユーザーの責任です。 または、要求の IP アドレスに基づいてマップ データを返す 'View = Auto' を設定することもできます。 Azure Maps の View パラメーターは、マップ、画像、その他のデータ、および Azure Maps 経由でアクセスする権限を持つサード パーティのコンテンツが利用可能になる国/地域のマッピングに関する法律を含む、適用される法律に準拠して使用する必要があります。 例: view=IN。

詳細については、「 サポートされているビュー」 を参照し、使用可能なビューを参照してください。

integer

結果の画像の幅 (ピクセル単位)。 範囲は 80 から 2000 です。 既定値は 512 です。 bbox では使用しないでください。

integer

マップの目的のズーム レベル。 tilesetId が microsoft.base.road または microsoft.base.darkgrey のズーム値範囲を 0 から 20 (両端を含む) をサポートします。 tilesetId が microsoft.imagery である場合、ズーム値の範囲を 0 から 19 (両端を含む) をサポートします。 既定値は 12 です。

詳細については、「 ズーム レベルとタイル グリッド」を参照してください。