Поделиться через

Заметки о выпуске элемента управления картой веб-пакета SDK

  • Статья

В этом документе содержатся сведения о новых функциях и других изменениях элемента управления картой.

версия 3 (последняя версия)

3.5.0 (CDN: 4 ноября 2024 г., npm: 7 ноября)

Новые возможности

  • Добавьте поддержку полноэкранного элемента управления.

Исправления ошибок

  • Предоставление поддержки DataDrivenPropertyValueSpecification<string>нового типаPolygonExtrusionLayerOptions.fillPattern.

3.4.0 (CDN: 30 сентября 2024 г., npm: 2 октября)

Новые возможности

  • Добавьте поддержку PMTiles.

Исправления ошибок

  • Специальные возможности. Исправлена проблема переполнения с меткой средства выбора стилей в небольших контейнерах.
  • Исправление атрибута, не обновляемого после изменения стиля с помощью источника данных GeoJSON.
  • Исправление setCamera с ограничениями и максимальным масштабом.
  • Используйте ResizeObserver вместо событий изменения размера окна.
  • Исправлена ширина логотипа нижнего колонтитула.

Другие изменения

  • Добавьте @types/geojson в качестве зависимости.
  • Обновление зависимости @microsoft/applicationinsights-web до ^3.3.0

3.3.0 (8 августа 2024 г.)

Новые возможности

  • Обновление элемента управления авторскими правами
    • Сделайте текст авторских прав меньшим и убедитесь, что он соответствует одной строке.
    • Используйте различные типы логотипов Майкрософт для различных тем CSS для улучшения видимости.
    • Реализуйте RWD, чтобы скрыть часть компонента (логотип MS), когда холст карты относительно мал.
  • Улучшение класса базового слоя путем добавления абстрактных getOptions и setOptions функций.

Исправления ошибок

  • Пропуск существующих источников при копировании уровней пользователей.
  • [КРИТИЧЕСКОЕ] Укажите неправильное упорядочение значений Position.fromLatLng()широты и долготы.
  • Исправлена скрытая проблема с видимым элементом со специальными возможностями на кнопках управления.

3.2.1 (13 мая 2024 г.)

Новые возможности

  • Ограничение горизонтального сдвига, если renderWorldCopies задано значение false.
  • Сделать easeTo и flyTo анимацию более гладкой, когда целевая точка близка к ограничениям: maxBounds, вертикальные края мира или antimeridian.

Исправления ошибок

  • Исправьте доступные номера для скрытых элементов управления при использовании команды "Показать числа".
  • Исправьте утечку памяти в рабочей роли при удалении карты.
  • Исправьте нежелательные изменения масштабирования и сдвига в конце движения сдвига.

Другие изменения

  • Улучшение формата встроенного кода в документе.

3.2.0 (29 марта 2024 г.)

Другие изменения

  • Обновление MapLibre до версии 4.

  • Исправьте значение HtmlMarkerOptions.pixelOffset по умолчанию из [0, 0] [0, -18] документа в документ.

3.1.2 (22 февраля 2024 г.)

Новые возможности

  • fillAntialias Добавлен параметр включения PolygonLayer защиты MSAA для заливки многоугольников.

Другие изменения

  • Обновите значок обратной связи и ссылку.

3.1.1 (26 января 2024 г.)

Новые возможности

  • Добавлен новый параметр, enableAccessibilityLocationFallbackчтобы включить или отключить резервный вариант API обратного геокодирования для специальных возможностей (средство чтения с экрана).

Исправления ошибок

  • Устранена проблема, из-за которой ApplicationInsights версии 3.0.5 потенциально отправлял большое количество запросов.

3.1.0 (12 января 2024 г.)

Новые возможности

  • Добавлен новый элемент управления для atlas.control.ScaleControlотображения шкалы на карте.

  • Введены функции для доступа, обновления и удаления состояния компонента.

Исправления ошибок

  • Устранена проблема упорядочивания слоев после обновления стиля при вставке пользовательского слоя перед другим уровнем пользователя.

  • [КРИТИЧЕСКОЕ] Выровнено поведение шаблона заливки многоугольников с помощью Maplibre. fillPattern Теперь параметр последовательно отключает fillColor этот параметр. При настройке fillColor слоев многоугольников убедитесь, что fillPattern задано значение undefined.

3.0.3 (29 ноября 2023 г.)

Новые возможности

  • Включена поддержка ESM.

Другие изменения

  • Функция специальных возможностей для средства чтения с экрана была обновлена, чтобы использовать API поиска версии 2 (обратная геокодирование).

  • Расширенные специальные возможности в элементах управления Compass и Pitch.

3.0.2 (1 ноября 2023 г.)

Исправления ошибок

  • Устранена несколько ошибок в файле объявления типа и добавлена зависимость для @maplibre/maplibre-gl-style-spec.

Другие изменения

  • Удалены заголовки авторизации из стиля, эскиза, спрайта и глифа запросов для улучшения кэширования CDN для статических ресурсов.

  • Обновлена документация для map.clear() и layers.clear().

3.0.1 (6 октября 2023 г.)

Исправления ошибок

  • Различные улучшения специальных возможностей.

  • Устранена проблема с динамической атрибуцией при включенной прогрессивной загрузке.

  • Исправлено отсутствие имен событий в HtmlMarkerEvents.

Другие изменения

  • Измененные методы элементов, которые будут защищены для элементов управления масштабированием, шагом и компасом.

  • Данные телеметрии отключены по умолчанию в облаке Azure для государственных организаций.

3.0.0 (18 августа 2023 г.)

Исправления ошибок

  • Фиксированный элемент управления масштабированием для учета maxBounds CameraOptions.

  • Исправлена проблема, из-за которой позиции мыши сдвигаются после преобразования масштабирования css в контейнере карты.

Другие изменения

  • Поэтапно отключили версию 2022-08-05 определения стиля и переключили значение по умолчанию styleDefinitionsVersion 2023-01-01.

  • Добавлен mvc параметр для охвата версии элемента управления картой как в определениях, так и в запросах стиля.

Установка

Версия доступна в npm и CDN.

  • NPM: см. инструкции по azure-maps-control@3.0.0.0

  • CDN: ссылка на следующие CSS и JavaScript в <head> элементе HTML-файла:

    <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 (11 июля 2023 г.)

Исправления ошибок

  • Коэффициент динамического пикселя, фиксированный в базовой зависимости maplibre-gl.

  • Исправлена проблема, variableAnchor из-за которой sortKey,radialOffsetне применяется при использовании в SymbolLayer параметрах.

Установка

Предварительная версия доступна в npm и CDN.

  • NPM: см. инструкции по azure-maps-control@3.0.0-preview.10

  • CDN: ссылка на следующие CSS и JavaScript в <head> элементе HTML-файла:

    <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 (27 июня 2023 г.)

Новые возможности

  • WebGL2 используется по умолчанию.

  • API повышения прав: atlas.sources.ElevationTileSource, map.enableElevation(elevationSource, options)map.disableElevation()

  • Возможность настройки maxPitch / minPitch в CameraOptions

Исправления ошибок

  • Исправлена проблема, из-за которой повторяющиеся элементы DOM, связанные со специальными возможностями, могут привести к map.setServiceOptions вызову

Установка

Предварительная версия доступна в npm и CDN.

  • NPM: ознакомьтесь с инструкциями в azure-maps-control@3.0.0-preview.9

  • CDN: ссылка на следующие CSS и JavaScript в <head> элементе HTML-файла:

    <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 (2 июня 2023 г.)

Исправления ошибок

  • Исправлено исключение, которое произошло при обновлении свойства макета, который больше не существует.

  • Исправлена проблема, из-за которой индикаторы доступности BubbleLayer не обновлялись при изменении источника данных.

  • Исправлена ошибка при последующих map.setStyle() вызовах, если необработанный стиль Maplibre извлекается в обратном вызове stylechanged события при сериализации стилей.

Другие изменения

  • Обновлен логотип и ссылка на атрибуцию.

Установка

Предварительная версия доступна в npm и CDN.

  • NPM: см. инструкции по azure-maps-control@3.0.0-preview.8

  • CDN: ссылка на следующие CSS и JavaScript в <head> элементе HTML-файла:

    <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 (2 мая 2023 г.)

Новые возможности

  • Помимо конфигурации карты Map.setServiceOptions() теперь поддерживает изменение domain, styleAPIVersionstyleDefinitionsVersion в среде выполнения.

Исправления ошибок

  • Исправлено исключение с истекшим сроком действия маркера при повторном запуске при использовании Azure AD/ общего маркера или анонимной проверки подлинности, убедившись, что проверка подлинности разрешена до любого запроса на определение стиля

  • Исправлено определение избыточного стиля и запросы эскизов

  • Исправлена ошибка aria-label , примененная к элементу кнопки масштабирования

  • Исправлена возможность неопределенного контейнера элементов авторских прав, если параметру withRuleBasedAttribution присвоено значение false.

  • Исправлена возможность удаления прослушивателя событий, вызываемого для неопределенного целевого объекта в EventManager.remove()

Установка

Предварительная версия доступна в npm и CDN.

  • NPM: инструкции по azure-maps-control@3.0.0-preview.7

  • CDN: ссылка на следующие CSS и JavaScript в <head> элементе HTML-файла:

    <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 (31 марта 2023 г.)

Установка

Предварительная версия доступна в npm и CDN.

  • NPM: ознакомьтесь с инструкциями в azure-maps-control@3.0.0-preview.6

  • CDN: ссылка на следующие CSS и JavaScript в <head> элементе HTML-файла:

    <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 (15 марта 2023 г.)

Установка

Предварительная версия доступна в npm и CDN.

  • NPM: инструкции по azure-maps-control@3.0.0-preview.5

  • CDN: ссылка на следующие CSS и JavaScript в <head> элементе HTML-файла:

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

Новые возможности

  • Поддержка динамического обновления mapConfiguration с помощью map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' })

3.0.0-preview.4 (10 марта 2023 г.)

Установка

Предварительная версия доступна в npm и CDN.

  • NPM. См. инструкции по azure-maps-control@3.0.0-preview.4

  • CDN: ссылка на следующие CSS и JavaScript в <head> элементе HTML-файла:

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

Новые возможности

  • Расширенное покрытие карты в Китае, Японии и Корее.

  • Предварительный просмотр обновленных стилей карты (дорога/ ночь/ гибридная / серая шкала темный/ серый свет/ серый масштаб свет/ terra/ высокая контрастность темный / высокий контрастный свет).

  • Дополнительные сведения о дорогах/ зданиях следов/покрытия следов.

  • Более широкие диапазоны уровней масштабирования (1~21) для стиля Terra.

  • Более подробные сведения об общественном транспорте, включая паромы, метро и автобусные остановки.

  • Дополнительные сведения о высоте гор и расположении водопадов.

Изменения

  • Данные трафика теперь поддерживают только относительный режим.

  • Не рекомендуется showBuildingModels использовать в StyleOptions.

  • Изменено значение по умолчанию minZoom от -2 до 1.

Исправления ошибок

  • Очистка различных утечек памяти в Map.dispose().

  • Улучшена навигация по вкладке выбора стилей для специальных возможностей в макете списка.

  • Оптимизированное переключение стиля, избегая глубокого клонирования объектов.

  • Исправлено исключение, которое произошло в SourceManager при переключении стилей с источниками, которые не были векторами или растрами.

  • [КРИТИЧЕСКОЕ] Ранее sourceadded события создаются только в том случае, если новые источники добавляются в стиль. Теперь sourceremoved / sourceadded события создаются, когда новый источник и исходный источник в текущем стиле не равны, даже если он имеет один и тот же исходный идентификатор.

3.0.0-preview.3 (2 февраля 2023 г.)

Установка

Предварительная версия доступна в npm и CDN.

  • NPM: ознакомьтесь с инструкциями в azure-maps-control@3.0.0-preview.3

  • CDN: ссылка на следующие CSS и JavaScript в <head> элементе HTML-файла:

    <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 на @azure/msal-browser , используемый для проверки подлинности с помощью Microsoft Azure Active Directory (Azure AD). Изменения, которые могут потребоваться:

    • Platform / Reply URL Тип должен быть задан Single-page application на портале регистрации приложений Azure AD.
    • Изменение кода требуется, если используется пользователь authOptions.authContext .
    • Дополнительные сведения см. в статье о переносе приложения JavaScript из ADAL.js в MSAL.js.

  • Разрешить настройку шагов и опор с помощью CameraBoundsOptions в Map.setCamera(options).

Исправления ошибок

  • Исправлена проблема в сопоставлении языков, теперь zh-Hant-TW больше не возвращается к en-US.

  • Исправлена неспособность переключаться между регионами пользователей (представлением).

  • Исправлено исключение, которое произошло при переключении стилей во время постепенной загрузки слоя.

  • Исправлено получение сведений о специальных возможностях из слоев меток плиток карты.

  • Исправлена случайная проблема, из-за которой векторные плитки не перенаправляемы после добавления изображений с помощью ImageSpriteManager.add().

3.0.0-preview.2 (16 декабря 2022 г.)

Установка

Предварительная версия доступна в npm и CDN.

  • NPM: см. инструкции по azure-maps-control@3.0.0-preview.2

  • CDN: ссылка на следующие CSS и JavaScript в <head> элементе HTML-файла:

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

  • Исправлена возможность отключения инцидентов трафика в TrafficControlOptions при new atlas.control.TrafficControl({incidents: false}) использовании.

  • Добавьте .atlas-map все селекторы css для области стилей в контейнере карты. Исправление предотвращает случайное добавление нежелательных стилей в другие элементы на странице.

3.0.0-preview.1 (18 ноября 2022 г.)

Установка

Предварительная версия доступна в npm.

Новые возможности

Это обновление является первой предварительной версией предстоящего выпуска 3.0.0. Базовая зависимость maplibre-gl была обновлена до 1.14 3.0.0-pre.1, предлагая улучшения стабильности и производительности.

Исправления ошибок

  • Исправлена проблема регрессии, которая предотвращает удаление набора плиток в ПомещенииManager:

    indoorManager.setOptions({
    tilesetId: undefined
})

Версия 2

2.3.7 (22 февраля 2024 г.)

Новые возможности

  • fillAntialias Добавлен параметр включения PolygonLayer защиты MSAA для заливки многоугольников.
  • Добавлен новый параметр, enableAccessibilityLocationFallbackчтобы включить или отключить резервный вариант API обратного геокодирования для специальных возможностей (средство чтения с экрана).

Другие изменения

  • Обновите значок обратной связи и ссылку.

2.3.6 (12 января 2024 г.)

Новые возможности

  • Добавлен новый элемент управления для atlas.control.ScaleControlотображения шкалы на карте.

  • Введены функции для доступа, обновления и удаления состояния компонента.

Исправления ошибок

  • Устранена проблема упорядочивания слоев после обновления стиля при вставке пользовательского слоя перед другим уровнем пользователя.

2.3.5 (29 ноября 2023 г.)

Другие изменения

  • Функция специальных возможностей для средства чтения с экрана была обновлена, чтобы использовать API поиска версии 2 (обратная геокодирование).

2.3.4 (1 ноября 2023 г.)

Другие изменения

  • Удалены заголовки авторизации из стиля, эскиза, спрайта и глифа запросов для улучшения кэширования CDN для статических ресурсов.

  • Обновлена документация для map.clear() и layers.clear().

2.3.3 (6 октября 2023 г.)

Исправления ошибок

  • Устранена проблема с динамической атрибуцией при включенной прогрессивной загрузке.

2.3.2 (11 августа 2023 г.)

Исправления ошибок

  • Исправлена проблема, из-за которой повторяющиеся элементы DOM, связанные со специальными возможностями, могут привести к map.setServiceOptions вызову.

  • Фиксированный элемент управления масштабированием для учета maxBounds CameraOptions.

Другие изменения

  • Добавлен mvc параметр для охвата версии элемента управления картой как в определениях, так и в запросах стиля.

2.3.1 (27 июня 2023 г.)

Исправления ошибок

  • Устранение ImageSpriteManager изображений значков может быть удалено во время изменения стиля

Другие изменения

  • Безопасность: исправление небезопасной случайности в поколении UUID.

2.3.0 (2 июня 2023 г.)

Новые возможности

  • [КРИТИЧЕСКОЕ] Рефакторинг внутреннего StyleManager для замены _stylePatch transformStyle. Это изменение позволит значкам дорожного щита обновлять и отрисовывать их правильно после переключения стиля.

Исправления ошибок

  • Исправлено исключение, которое произошло при обновлении свойства макета, который больше не существует.

  • Исправлена проблема, из-за которой индикаторы доступности BubbleLayer не обновлялись при изменении источника данных.

Другие изменения

  • Обновлен логотип и ссылка на атрибуцию.

2.2.7 (2 мая 2023 г.)

Новые возможности

  • Помимо конфигурации карты Map.setServiceOptions() теперь поддерживает изменение domain, styleAPIVersionstyleDefinitionsVersion в среде выполнения.

Исправления ошибок

  • Исправлено исключение с истекшим сроком действия маркера при повторном запуске при использовании Azure AD/ общего маркера или анонимной проверки подлинности, убедившись, что проверка подлинности разрешена до любого запроса на определение стиля

  • Исправлено определение избыточного стиля и запросы эскизов

  • Исправлена ошибка aria-label , примененная к элементу кнопки масштабирования

  • Исправлена возможность неопределенного контейнера элементов авторских прав, если параметру withRuleBasedAttribution присвоено значение false.

  • Исправлена возможность удаления прослушивателя событий, вызываемого для неопределенного целевого объекта в EventManager.remove()

2.2.6

Исправления ошибок

  • Устранена проблема, из-за которой первый запрос набора стилей не прошел проверку подлинности AAD .

  • Устранены избыточные запросы во время инициализации карты и события изменения стиля.

2.2.5

Новые возможности

  • Поддержка динамического обновления mapConfiguration с помощью map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' })

2.2.4

Исправления ошибок

  • Очистка различных утечек памяти в Map.dispose().

  • Улучшена навигация по вкладке выбора стилей для специальных возможностей в макете списка.

2.2.3

Новые возможности

Исправления ошибок

  • Исправлена проблема в сопоставлении языков, теперь zh-Hant-TW больше не возвращается к en-US.

  • Исправлена неспособность переключаться между регионами пользователей (представлением).

  • Исправлено исключение, которое произошло при переключении стилей во время постепенной загрузки слоя.

  • Исправлено получение сведений о специальных возможностях из слоев меток плиток карты.

  • Исправлена случайная проблема, из-за которой векторные плитки не перенаправляемы после добавления изображений с помощью ImageSpriteManager.add().

2.2.2 (15 декабря 2022 г.)

Новые возможности

Добавьте progressiveLoading и progressiveLoadingInitialLayerGroups в StyleOptions , чтобы обеспечить возможность загрузки слоев карты постепенно. Эта функция улучшает предполагаемое время загрузки карты.

  • progressiveLoading
    • Обеспечивает прогрессивную загрузку слоев карты.
    • По умолчанию — false.
  • progressiveLoadingInitialLayerGroups
    • Указывает группы слоев, которые нужно загрузить сначала.
    • По умолчанию — ["base"].
    • Возможные значения: base, transit, labels, buildingsи labels_places.
    • Другие группы слоев откладываются таким образом, чтобы начальные группы слоев могли быть загружены сначала.

Исправления ошибок

  • Исправлена проблема, из-за которой порядок уровней пользователей не сохранялся после вызова map.layers.move().

  • Исправлена возможность отключения инцидентов трафика в TrafficControlOptions при new atlas.control.TrafficControl({incidents: false}) использовании.

Следующие шаги

Ознакомьтесь с примерами, демонстрирующими Azure Maps:

Примеры Azure Maps

Будьте в курсе последних событий в работе службы Azure Maps:

Блог по Azure Maps