Web SDK マップ コントロールのリリース ノート
このドキュメントには、マップ コントロールの新機能とその他の変更に関する情報が記載されています。
v3 (最新)
3.5.0 (CDN: 2024 年 11 月 4 日、npm: 11 月 7 日)
新機能
- 全画面表示コントロールのサポートを追加します。
バグ修正
DataDrivenPropertyValueSpecification<string>
をサポートするために、PolygonExtrusionLayerOptions.fillPattern
で新しい型を公開します。
3.4.0 (CDN: 2024 年 9 月 30 日、npm: 10 月 2 日)
新機能
- PMTiles のサポートを追加します。
バグ修正
- アクセシビリティ: 小さなコンテナーのスタイル ピッカー ラベルのオーバーフローの問題を修正します。
- GeoJSON データ ソースでスタイルの変更後に属性が更新されない問題を修正しました。
- 境界と最小/最大ズームで
setCamera
を修正します。 - ウィンドウサイズ変更イベントの代わりに
ResizeObserver
を使用します。 - フッターロゴの幅を修正しました。
その他の変更
- 依存関係として
@types/geojson
を追加します。 - 依存関係の
@microsoft/applicationinsights-web
を次に更新する^3.3.0
3.3.0 (2024 年 8 月 8 日)
新機能
- Copyright コントロールを更新する
- 著作権テキストを小さくし、1 行に収まるようにします。
- 可視性を向上させるために、CSS テーマごとに異なる種類の Microsoft ロゴを使用します。
- RWD を実装して、マップ キャンバスが比較的小さい場合にコンポーネントの一部 (MS ロゴ) を非表示にします。
- 抽象
getOptions
関数とsetOptions
関数を追加して、基本レイヤー クラスを強化します。
バグ修正
- ユーザー レイヤーをコピーするときに既存のソースをスキップします。
- [破壊的変更]
Position.fromLatLng()
の緯度と経度の値の正しくない順序に対処します。 - コントロール ボタンに表示される非表示のアクセス可能な要素の問題を修正しました。
3.2.1 (2024 年 5 月 13 日)
新機能
renderWorldCopies
がfalse
に設定されている場合は、水平方向のパンを制限します。- ターゲット ポイントが maxBounds、vertical world edges、antimeridian の制限に近い場合に、
easeTo
とflyTo
アニメーションをよりスムーズにします。
バグ修正
- [Show numbers]\(数値の表示\) コマンドを使用して、非表示のコントロールのアクセス可能な数値を修正します。
- マップが削除されたときにワーカーのメモリ リークを修正します。
- パンモーションの最後に不要なズームとパンの変更を修正します。
その他の変更
- ドキュメント内のインライン コードの形式を改善します。
3.2.0 (2024 年 3 月 29 日)
その他の変更
MapLibre を V4 にアップグレードします。
[0, -18]
からドキュメント内の[0, 0]
にHtmlMarkerOptions.pixelOffset
の既定値を修正します。
3.1.2 (2024 年 2 月 22 日)
新機能
- 多角形塗りつぶし
fillAntialias
MSAA アンチエイリアシングを有効にするためのPolygonLayer
オプションが追加されました。
その他の変更
- フィードバック アイコンとリンクを更新します。
3.1.1 (2024 年 1 月 26 日)
新機能
- アクセシビリティのための逆ジオコーディング API フォールバックを有効または無効にする新しいオプション (
enableAccessibilityLocationFallback
) を追加しました (スクリーン リーダー)。
バグ修正
- ApplicationInsights v3.0.5 が大量の要求を送信する可能性がある問題を解決しました。
3.1.0 (2024 年 1 月 12 日)
新機能
マップ上にスケール バーを表示する新しいコントロール (
atlas.control.ScaleControl
) を追加しました。機能状態にアクセス、更新、削除するための関数が導入されました。
バグ修正
ユーザー レイヤーが別のユーザー レイヤーの前に挿入されたときの、スタイルの更新後のレイヤーの順序付けの問題に対処しました。
[破壊的変更] 多角形の塗りつぶしパターンの動作を Maplibre に揃えました。 これで、
fillPattern
オプションは一貫してfillColor
オプションを無効にします。 多角形レイヤーのfillColor
を構成するときは、fillPattern
がundefined
に設定されていることを確認します。
3.0.3 (2023 年 11 月 29 日)
新機能
- ESM サポートが含まれています。
その他の変更
スクリーン リーダーのアクセシビリティ機能が、Search V2 API (逆ジオコーディング) を利用するようにアップグレードされました。
Compass コントロールと Pitch コントロールのアクセシビリティが強化されました。
3.0.2 (2023 年 11 月 1 日)
バグ修正
- 型宣言ファイル内のいくつかのエラーに対処し、
@maplibre/maplibre-gl-style-spec
の依存関係を追加しました。
その他の変更
静的アセットの CDN キャッシュを強化するために、スタイル、サムネイル、スプライト、グリフの要求から Authorization ヘッダーを削除しました。
map.clear()
とlayers.clear()
に関するドキュメントを更新しました。
3.0.1 (2023 年 10 月 6 日)
バグ修正
さまざまなアクセシビリティが向上しました。
プログレッシブ読み込みが有効になっている場合の動的属性に関する問題を解決しました。
HtmlMarkerEvents
イベント名の欠落を修正しました。
その他の変更
ズーム、ピッチ、コンパスの各コントロールで保護されるメンバー メソッドを変更しました。
Azure Government クラウドでは、テレメトリは既定で無効になっています。
3.0.0 (2023 年 8 月 18 日)
バグ修正
maxBounds
CameraOptionsを考慮に入れるズーム コントロールを修正しました。マップ コンテナー上で CSS の transform で scale を使用した後にマウスの位置が移動する問題を修正しました。
その他の変更
スタイル定義のバージョン
2022-08-05
を段階的に廃止し、既定値styleDefinitionsVersion
を2023-01-01
に切り替えました。定義とスタイル要求の両方でマップ コントロールのバージョンを包含する
mvc
パラメーターを追加しました。
インストール
バージョンは npm と CDN で入手できます。
NPM:azure-maps-control@3.0.0 の手順をご覧ください
CDN: HTML ファイルの
<head>
要素で次の CSS と JavaScript を参照してください。<link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0/atlas.min.css" rel="stylesheet" /> <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0/atlas.min.js"></script>
3.0.0-preview.10 (2023 年 7 月 11 日)
バグ修正
基になる maplibre-gl 依存関係で動的ピクセル比が修正されました。
SymbolLayer
オプションで使用された場合にsortKey
、radialOffset
、variableAnchor
が適用されない問題を修正しました。
インストール
プレビューは npm と CDN で入手できます。
NPM:azure-maps-control@3.0.0-preview.10 の手順をご覧ください
CDN: HTML ファイルの
<head>
要素で次の CSS と JavaScript を参照してください。<link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.10/atlas.min.css" rel="stylesheet" /> <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.10/atlas.min.js"></script>
3.0.0-preview.9 (2023 年 6 月 27 日)
新機能
既定では WebGL2 が使用されます。
Elevation API:
atlas.sources.ElevationTileSource
、map.enableElevation(elevationSource, options)
、map.disableElevation()
CameraOptions
で maxPitch/minPitch をカスタマイズする機能
バグ修正
map.setServiceOptions
が呼び出されたときに、アクセシビリティ関連の重複した DOM 要素が生じる場合がある問題を修正しました
インストール
プレビューは npm と CDN で入手できます。
NPM:azure-maps-control@3.0.0-preview.9 の手順をご覧ください
CDN: HTML ファイルの
<head>
要素で次の CSS と JavaScript を参照してください。<link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.9/atlas.min.css" rel="stylesheet" /> <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.9/atlas.min.js"></script>
3.0.0-preview.8 (2023 年 6 月 2 日)
バグ修正
存在しないレイアウトのプロパティを更新中に発生する例外を修正しました。
データ ソースが変更されたときに BubbleLayer のアクセシビリティ対応インジケーターが更新されない問題を修正しました。
スタイルのシリアル化の
stylechanged
イベント コールバックで生の Maplibre スタイルが取得された場合、後続のmap.setStyle()
呼び出しで発生するエラーを修正しました。
その他の変更
- 属性のロゴとリンクを更新しました。
インストール
プレビューは npm と CDN で入手できます。
NPM:azure-maps-control@3.0.0-preview.8 の手順をご覧ください
CDN: HTML ファイルの
<head>
要素で次の CSS と JavaScript を参照してください。<link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.8/atlas.min.css" rel="stylesheet" /> <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.8/atlas.min.js"></script>
3.0.0-preview.7 (2023 年 5 月 2 日)
新機能
- Map.setServiceOptions() では、マップ構成に加えて、実行時の
domain
、styleAPIVersion
、styleDefinitionsVersion
の変更がサポートされるようになりました。
バグ修正
スタイル定義要求の前に認証が解決されるようにすることで、Azure AD/共有トークン/匿名認証を使用するときに再起動でトークンの有効期限が切れる例外を修正しました
冗長なスタイル定義とサムネイル要求を修正しました
縮小コントロール ボタン要素に正しくない
aria-label
が適用されるのを修正しましたwithRuleBasedAttribution が false に設定されているときに、copyright 要素コンテナーが未定義になる可能性を修正しました
EventManager.remove()
で、未定義のターゲットに対してイベント リスナーの削除が呼び出される可能性を修正しました
インストール
プレビューは npm と CDN で入手できます。
NPM:azure-maps-control@3.0.0-preview.7 の手順をご覧ください
CDN: HTML ファイルの
<head>
要素で次の CSS と JavaScript を参照してください。<link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.7/atlas.min.css" rel="stylesheet" /> <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.7/atlas.min.js"></script>
3.0.0-preview.6 (2023 年 3 月 31 日)
インストール
プレビューは npm と CDN で入手できます。
NPM:azure-maps-control@3.0.0-preview.6 の手順をご覧ください
CDN: HTML ファイルの
<head>
要素で次の CSS と JavaScript を参照してください。<link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.6/atlas.min.css" rel="stylesheet" /> <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.6/atlas.min.js"></script>
新機能
- 内部スタイル変換のパフォーマンスを最適化しました。
バグ修正
最初のスタイル セット要求が
AAD
認証用に認証されていないイシューを解決しました。マップ初期化中とスタイル変更イベントでの冗長な要求を排除しました。
3.0.0-preview.5 (2023 年 3 月 15 日)
インストール
プレビューは npm と CDN で入手できます。
NPM:azure-maps-control@3.0.0-preview.5 の手順を参照してください
CDN: HTML ファイルの
<head>
要素で次の CSS と JavaScript を参照してください。<link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.5/atlas.min.css" rel="stylesheet" /> <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.5/atlas.min.js"></script>
新機能
map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' })
を使用した mapConfiguration の動的な更新をサポートする
3.0.0-preview.4 (2023 年 3 月 10 日)
インストール
プレビューは npm と CDN で入手できます。
NPM:azure-maps-control@3.0.0-preview.4 の手順を参照してください
CDN: HTML ファイルの
<head>
要素で次の CSS と JavaScript を参照してください。<link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.4/atlas.min.css" rel="stylesheet" /> <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.4/atlas.min.js"></script>
新機能
中国、日本、韓国のマップ カバレッジを拡張しました。
更新されたマップ スタイルのプレビュー (道路/夜/ハイブリッド/グレー スケール ダーク/グレー スケール ライト/テラ/ハイ コントラスト ダーク/ハイ コントラスト ライト)。
道路/建物のフットプリント/トレイルのカバレッジの詳細。
テラ スタイルのズーム レベル範囲の拡張 (1 から 21)。
フェリー、地下鉄、バス停などの公共交通機関の詳細の強化。
山の高度と滝の場所に関する追加情報。
変更点
トラフィック データで相対モードのみがサポートされるようになりました。
StyleOptions で
showBuildingModels
が非推奨になりました。minZoom
の既定値を -2 から 1 に変更しました。
バグ修正
Map.dispose() のさまざまなメモリ リークをクリーンアップしました。
リスト レイアウトでのアクセシビリティのために、スタイル ピッカーのタブ ナビゲーションを改善しました。
オブジェクトを深く複製することを回避することで、スタイルの切り替えを最適化しました。
ベクターまたはラスターではないソースでスタイルを切り替えるときに SourceManager で発生していた例外を修正しました。
[破壊的変更] 以前の
sourceadded
イベントは、新しいソースがスタイルに追加された場合にのみ生成されます。 現在は、新しいソースと現行スタイルの元のソースが等しくない場合、同じソース ID を持っている場合でもsourceremoved
/sourceadded
イベントが生成されます。
3.0.0-preview.3 (2023 年 2 月 2 日)
インストール
プレビューは npm と CDN で入手できます。
NPM:azure-maps-control@3.0.0-preview.3 の手順を参照してください
CDN: HTML ファイルの
<head>
要素で次の CSS と JavaScript を参照してください。<link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.3/atlas.min.css" rel="stylesheet" /> <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.3/atlas.min.js"></script>
新機能
[重大]adal-angular から、Microsoft Azure Active Directory (Azure AD) での認証に使用される @azure/msal-browser に移行されました。 必要な可能性がある変更:
Platform / Reply URL
Azure AD アプリ登録ポータルで、種類をSingle-page application
に設定する必要があります。- カスタム
authOptions.authContext
を使用する場合は、コードの変更が必要です。 - 詳細については、「JavaScript アプリを ADAL.js から MSAL.js に移行する方法」を参照してください。
Map.setCamera(options) の CameraBoundsOptions でピッチとベアリングを設定できるようにします。
バグ修正
言語マッピングの問題を修正しました。
zh-Hant-TW
はen-US
に戻らなくなります。ユーザー領域 (ビュー) を切り替えできないことを修正しました。
プログレッシブ レイヤーの読み込みが進行中のスタイルの切り替え時に発生した例外を修正しました。
マップ タイル ラベル レイヤーからのアクセシビリティ情報の取得を修正しました。
ImageSpriteManager.add() を使用してイメージを追加した後にベクター タイルが再レンダリングされない場合がある問題を修正しました。
3.0.0-preview.2 (2022 年 12 月 16 日)
インストール
プレビューは npm と CDN で入手できます。
NPM:azure-maps-control@3.0.0-preview.2 の手順を参照してください
CDN: HTML ファイルの
<head>
要素で次の CSS と JavaScript を参照してください。<link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.2/atlas.min.css" rel="stylesheet" /> <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.2/atlas.min.js"></script>
新機能
マップ レイヤーを段階的に読み込む機能を有効にする progressiveLoading
と progressiveLoadingInitialLayerGroups
を StyleOptions に追加しました。 この機能により、マップの知覚される読み込み時間が向上しました。 詳細については、2.2.2 のリリース ノートを参照してください。
バグ修正
map.layers.move()
を呼び出した後にユーザー レイヤーの順序が保持されない問題を修正しました。new atlas.control.TrafficControl({incidents: false})
が使われているときに TrafficControlOptions でトラフィック インシデントを無効にできないことを修正しました。マップ コンテナー内のスタイルの範囲を指定する
.atlas-map
をすべての css セレクターに追加しました。 この修正により、ページ上の他の要素に不要なスタイルが css によって誤って追加されなくなります。
3.0.0-preview.1 (2022 年 11 月 18 日)
インストール
プレビューは npm で入手できます。
azure-maps-control@next を依存関係にインストールしてください。
npm i azure-maps-control@next
新機能
この更新プログラムは、今後の 3.0.0 リリースの最初のプレビューです。 基となる maplibre-gl 依存関係は 1.14
から 3.0.0-pre.1
にアップグレードされ、安定性とパフォーマンスが向上しました。
バグ修正
IndoorManager がタイルセットを削除できない回帰の問題を修正しました。
indoorManager.setOptions({ tilesetId: undefined })
v2
2.3.7 (2024 年 2 月 22 日)
新機能
- 多角形塗りつぶし
fillAntialias
MSAA アンチエイリアシングを有効にするためのPolygonLayer
オプションが追加されました。 - アクセシビリティのための逆ジオコーディング API フォールバックを有効または無効にする新しいオプション (
enableAccessibilityLocationFallback
) を追加しました (スクリーン リーダー)。
その他の変更
- フィードバック アイコンとリンクを更新します。
2.3.6 (2024 年 1 月 12 日)
新機能
マップ上にスケール バーを表示する新しいコントロール (
atlas.control.ScaleControl
) を追加しました。機能状態にアクセス、更新、削除するための関数が導入されました。
バグ修正
- ユーザー レイヤーが別のユーザー レイヤーの前に挿入されたときの、スタイルの更新後のレイヤーの順序付けの問題に対処しました。
2.3.5 (2023 年 11 月 29 日)
その他の変更
- スクリーン リーダーのアクセシビリティ機能が、Search V2 API (逆ジオコーディング) を利用するようにアップグレードされました。
2.3.4 (2023 年 11 月 1 日)
その他の変更
静的アセットの CDN キャッシュを強化するために、スタイル、サムネイル、スプライト、グリフの要求から Authorization ヘッダーを削除しました。
map.clear()
とlayers.clear()
に関するドキュメントを更新しました。
2.3.3 (2023 年 10 月 6 日)
バグ修正
- プログレッシブ読み込みが有効になっている場合の動的属性に関する問題を解決しました。
2.3.2 (2023 年 8 月 11 日)
バグ修正
map.setServiceOptions
が呼び出されたときに、アクセシビリティ関連の重複した DOM 要素が生じる場合がある問題を修正しました。maxBounds
CameraOptionsを考慮に入れるズーム コントロールを修正しました。
その他の変更
- 定義とスタイル要求の両方でマップ コントロールのバージョンを包含する
mvc
パラメーターを追加しました。
2.3.1 (2023 年 6 月 27 日)
バグ修正
- スタイルの変更中に
ImageSpriteManager
アイコンの画像が削除される場合がある問題を修正しました
その他の変更
- セキュリティ: UUID 生成での安全でないランダム性の修正。
2.3.0 (2023 年 6 月 2 日)
新機能
- [速報] 内部 StyleManager をリファクタリングして、
_stylePatch
をtransformStyle
に置き換えました。 この変更により、スタイルの切り替え後に道路標識アイコンが更新され、適切にレンダリングされるようになります。
バグ修正
存在しないレイアウトのプロパティを更新中に発生する例外を修正しました。
データ ソースが変更されたときに BubbleLayer のアクセシビリティ対応インジケーターが更新されない問題を修正しました。
その他の変更
- 属性のロゴとリンクを更新しました。
2.2.7 (2023 年 5 月 2 日)
新機能
- Map.setServiceOptions() では、マップ構成に加えて、実行時の
domain
、styleAPIVersion
、styleDefinitionsVersion
の変更がサポートされるようになりました。
バグ修正
スタイル定義要求の前に認証が解決されるようにすることで、Azure AD/共有トークン/匿名認証を使用するときに再起動でトークンの有効期限が切れる例外を修正しました
冗長なスタイル定義とサムネイル要求を修正しました
縮小コントロール ボタン要素に正しくない
aria-label
が適用されるのを修正しましたwithRuleBasedAttribution が false に設定されているときに、copyright 要素コンテナーが未定義になる可能性を修正しました
EventManager.remove() で、未定義のターゲットに対してイベント リスナーの削除が呼び出される可能性を修正しました
2.2.6
バグ修正
最初のスタイル セット要求が
AAD
認証用に認証されていないイシューを解決しました。マップ初期化中とスタイル変更イベントでの冗長な要求を排除しました。
2.2.5
新機能
map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' })
を使用した mapConfiguration の動的な更新をサポートする
2.2.4
バグ修正
Map.dispose() のさまざまなメモリ リークをクリーンアップしました。
リスト レイアウトでのアクセシビリティのために、スタイル ピッカーのタブ ナビゲーションを改善しました。
2.2.3
新機能
- Map.setCamera(options) の CameraBoundsOptions でピッチとベアリングを設定できるようにします。
バグ修正
言語マッピングの問題を修正しました。
zh-Hant-TW
はen-US
に戻らなくなります。ユーザー領域 (ビュー) を切り替えできないことを修正しました。
プログレッシブ レイヤーの読み込みが進行中のスタイルの切り替え時に発生した例外を修正しました。
マップ タイル ラベル レイヤーからのアクセシビリティ情報の取得を修正しました。
ImageSpriteManager.add() を使用してイメージを追加した後にベクター タイルが再レンダリングされない場合がある問題を修正しました。
2.2.2 (2022 年 12 月 15 日)
新機能
マップ レイヤーを段階的に読み込む機能を有効にする progressiveLoading
と progressiveLoadingInitialLayerGroups
を StyleOptions に追加しました。 この機能により、マップの知覚される読み込み時間が向上しました。
progressiveLoading
- マップ レイヤーの段階的な読み込みを可能にしました。
- 既定値は
false
です。
progressiveLoadingInitialLayerGroups
- 最初に読み込むレイヤー グループを指定してください。
- 既定値は
["base"]
です。 - 指定できる値は、
base
、transit
、labels
、buildings
、labels_places
です。 - 最初のレイヤー グループを最初に読み込むことができるように、他のレイヤー グループは遅延されます。
バグ修正
map.layers.move()
を呼び出した後にユーザー レイヤーの順序が保持されない問題を修正しました。new atlas.control.TrafficControl({incidents: false})
が使われているときに TrafficControlOptions でトラフィック インシデントを無効にできないことを修正しました。
次の手順
Azure Maps を紹介するサンプルを確認してください。
Azure Maps に関する最新情報を受け取る。