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 エンコードしてください)。

Path パラメーターは、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 つのインスタンスのみがサポートされ、場所の数はピンあたり 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 です。

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