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 (int32)

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

string

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

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

string[]

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

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

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

path=ra100||-122 45

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

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

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

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

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[]

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

Azure MapsアカウントのS0 SKUはピンパラメータのインスタンスを1つしかサポートせず、1ピンあたりの位置数は5つに制限されています。 その他の SKU では、ピン パラメーターのインスタンスを最大 25 個まで使用して複数のピン スタイルを指定でき、場所の数はピンあたり 50 個に制限されます。

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

pins=default||-122 45

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

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

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

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

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

ラベルは、プッシュピン 'ラベル アンカー' の中央に配置されます。 アンカー位置は組み込みのプッシュピン用に事前に定義されており、カスタム プッシュピンの上部中央にあります (下記参照)。 ラベル アンカーをオーバーライドするには、'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 です。 既定値は none で、トラフィック フローが返されていないことを示します。 トラフィック関連の tilesetId が指定されている場合は、対応するトラフィック レイヤーを持つマップ イメージが返されます。 詳細については、「Render TilesetId」を参照してください。

LocalizedMapView

View パラメーター ("ユーザーリージョン" パラメーターとも呼ばれます) を使用すると、地政学的に紛争が生じしている地域の特定の国/地域の正しいマップを表示できます。 このようなリージョンのビューは国や地域によって異なります。また、View パラメーターを使用すると、アプリケーションがサービスを提供する国/地域で必要なビューにアプリケーションを準拠できます。 既定では、要求で定義していない場合でも、View パラメーターは "Unified" に設定されます。 ユーザーの場所を特定し、その場所に対して View パラメーターを正しく設定するのは、ユーザーの責任です。 または、要求の IP アドレスに基づいてマップ データを返す 'View=Auto' を設定することもできます。 Azure MapsのViewパラメータは、地図、画像、その他のデータ、第三者コンテンツがAzure Mapsを通じて公開されている国・地域の適用法、地図に関する法律を遵守して使用されなければなりません。 例: view=IN。

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

integer (int32)

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

integer (int32)

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

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