Создатель (Предварительная версия) для карт для помещенийCreator (Preview) for indoor maps

Важно!

Службы Creator Azure Maps в настоящее время доступны в общедоступной предварительной версии.Azure Maps Creator services are currently in public preview. Эта предварительная версия предоставляется без соглашения об уровне обслуживания и не рекомендована для использования рабочей среде.This preview version is provided without a service level agreement, and it's not recommended for production workloads. Некоторые функции могут не поддерживаться или их возможности могут быть ограничены.Certain features might not be supported or might have constrained capabilities. Дополнительные сведения см. в статье Дополнительные условия использования предварительных выпусков Microsoft Azure.For more information, see Supplemental Terms of Use for Microsoft Azure Previews.

В этой статье описываются основные понятия и средства, которые применяются к службе Creator в Azure Maps.This article introduces concepts and tools that apply to Azure Maps Creator. Рекомендуется ознакомиться с этой статьей перед началом работы с API-интерфейсом и пакетом SDK службы Creator в Azure Maps.We recommend that you read this article before you begin to use the Azure Maps Creator API and SDK.

Вы можете использовать Creator для разработки приложений с возможностями построения схем на основе данных о схеме помещения.You can use Creator to develop applications with map features based on indoor map data. В этой статье описывается процесс передачи, преобразования, создания и использования данных схем.This article describes the process of uploading, converting, creating, and using your map data. Весь рабочий процесс показан на приведенной ниже схеме.The entire workflow is illustrated in the diagram below.

Рабочий процесс обработки данных схемы в Creator

Создание Azure Maps Creator (Предварительная версия)Create Azure Maps Creator (Preview)

Чтобы использовать службы Creator (Предварительная версия), Azure Maps Creator необходимо создать в учетной записи Azure Maps.To use Creator services (Preview), Azure Maps Creator must be created in an Azure Maps account. Сведения о создании ресурса Creator в Azure Maps см. в разделе Управление службой Creator в Azure Maps.For information on how to create Azure Maps Creator in Azure Maps, see Manage Azure Maps Creator.

Отправка пакета рисунковUpload a Drawing package

Создатель (Предварительная версия) собирает данные карт путем преобразования отправленного пакета рисования.Creator (Preview) collects indoor map data by converting an uploaded Drawing package. Пакет рисунков представляет сконструированное или переконструированное здание.The Drawing package represents a constructed or remodeled facility. Сведения о требованиях к пакету рисунков см. в статье Требования к пакету рисунков.For information on Drawing package requirements, see Drawing package requirements.

Используйте API отправки Azure Maps Data (Preview) для отправки пакета Drawing.Use the Azure Maps Data (Preview) Upload API to upload a Drawing package. После успешной передачи API-интерфейс отправки данных вернет идентификатор пользовательских данных (udid).Upon a successful upload, the Data Upload API will return a user data identifier (udid). udid будет использоваться на следующем шаге для преобразования переданного пакета в данные схемы помещения.The udid will be used in the next step to convert the uploaded package into indoor map data.

Преобразование пакета рисунковConvert a Drawing package

Служба преобразования Azure Maps преобразует переданный пакет рисунков в данные схемы помещения.The Azure Maps Conversion service converts an uploaded Drawing package into indoor map data. Она также проверяет пакет.The Conversion service also validates the package. Обнаруженные при проверке проблемы делятся на два типа: ошибки и предупреждения.Validation issues are classified into two types: errors and warnings. При обнаружении ошибок происходит сбой процесса преобразования.If any errors are detected, the conversion process fails. При обнаружении предупреждений, преобразование будет выполнено.Should warnings be detected, the conversion will succeed. Однако рекомендуется просмотреть все предупреждения и устранять указанные в них проблемы.However, it's recommended that you review and resolve all warnings. Предупреждение означает, что часть преобразования была пропущена или исправлена автоматически.A warning means that part of the conversion was ignored or automatically fixed. Если не разрешить проблему, ставшую причиной предупреждения, это может привести к ошибкам в последующих процессах.Failing to resolve the warnings could result in errors in latter processes. Дополнительные сведения см. в статье Ошибки и предупреждения для пакета рисунков.For more information, see Drawing package warnings and errors.

В случае ошибки служба преобразования предоставляет ссылку на автономное веб-приложение Визуализатор ошибок рисования в Azure Maps.When an error occurs, the Conversion service provides a link to the Azure Maps Drawing Error Visualizer stand-alone web application. Визуализатор ошибок рисования можно использовать для проверки предупреждений и ошибок в пакете рисования, сообщения о которых были получены в процессе преобразования.You can use the Drawing Error Visualizer to inspect Drawing package warnings and errors that occurred during the conversion process. После устранения ошибок можно попытаться отправить и преобразовать пакет.Once you have fixed the errors, you can then attempt to upload and convert the package.

Создание данных схем помещенийCreate indoor map data

Создатель Azure Maps (Предварительная версия) предоставляет три службы:Azure Maps Creator (Preview) provides three services:

  • Служба набора данных.Dataset service. Используется для создания набора данных из преобразованных данных пакета рисунков.Use the Dataset service to create a dataset from a converted Drawing package data.
  • Служба набора фрагментов.Tileset service. Используется для создания векторного представления набора данных.Use the Tileset service to create a vector-based representation of a dataset. Приложения могут использовать набор фрагментов для визуального представления набора данных на основе фрагментов.Applications can use a tileset to present a visual tile-based view of the dataset.
  • Служба состояний признаков. Используется для обеспечения поддержки динамической настройки стиля схем.Feature State service.Use the Feature State service to support dynamic map styling. Эта возможность позволяет приложениям отражать события в реальном времени на пространствах, предоставляемых системой Интернета вещей.Dynamic map styling allows applications to reflect real-time events on spaces provided by IoT system.

Наборы данныхDatasets

Набор данных — это коллекция признаков схемы помещения.A dataset is a collection of indoor map features. Признак схемы помещения представляет средства, определенные в преобразованном пакете рисунков.The indoor map features represent facilities defined in a converted Drawing package. После создания набора данных с помощью службы набора данных можно создать любое количество наборов фрагментов или наборов состояний функции.After creating a dataset with the Dataset service, you can create any number of tilesets or feature statesets.

Служба набора данных позволяет разработчикам в любое время добавлять или удалять средства в существующем наборе данных.The Dataset service allows developers, at any time, to add or remove facilities to an existing dataset. Дополнительные сведения о том, как обновить существующий набор данных с помощью API-интерфейса, см. в разделе о вариантах добавления в статье о службе наборов данных.For more information on how to update an existing dataset using the API, see the append options in Dataset service. Пример обновления набора данных см. в разделе Обслуживание данных.For an example of how to update a dataset, see Data Maintenance.

Наборы фрагментовTilesets

Набор фрагментов — это коллекция векторных данных, представляющих ряд однородных фрагментов сетки.A tileset is a collection of vector data that represents a set of uniform grid tiles. Разработчики могут использовать службу набора фрагментов для создания набора фрагментов из набора данных.Developers can use the Tileset service to create tilesets from a dataset.

Чтобы отразить различные этапы наполнения содержимым, можно создать несколько наборов фрагментов из одного набора данных.To reflect different content stages, you can create multiple tilesets from the same dataset. Например, можно создать один набор фрагментов с мебелью и оборудованием, а другой — без них.For example, you could make one tileset with furniture and equipment, and another tileset without furniture and equipment. Вы можете также создать один набор фрагментов с самыми последними обновлениями данных, а другой — без них.You might choose to generate one tileset with the most recent data updates, and one without the most recent data updates.

Помимо векторных данных, набор фрагментов предоставляет метаданные для оптимизации отрисовки схемы.In addition to the vector data, the tileset provides metadata for map rendering optimization. Например, метаданные набора фрагментов содержат предусмотренный для него минимальный и максимальный масштаб.For example, tileset metadata contains a min and max zoom level for the tileset. Метаданные также предоставляют ограничивающий прямоугольник, определяющий географический экстент набора фрагментов.The metadata also provides a bounding box defining the geographic extent of the tileset. Ограничивающий прямоугольник позволяет приложению программно задавать правильную центральную точку.The bounding box allows an application to programmatically set the correct center point. Дополнительные сведения о метаданных набора фрагментов см. в статье API списка наборов фрагментов.For more information about tileset metadata, see Tileset List API.

После создания набор фрагментов можно получить с помощью службы Render V2.Once a tileset has been created, it can be retrieved by the Render V2 service.

Если набор фрагментов устарел и больше не используется, его можно удалить.If a tileset becomes outdated and is no longer useful, you can delete the tileset. Дополнительные сведения об удалении набор фрагментов см. в разделе Обслуживание данных.For more information on how to delete tilesets, see Data Maintenance.

Примечание

Набор фрагментов не зависит от набора данных, из которого он создан.A tileset is independent of the dataset from which it was created. В случае создания набора фрагментов из набора данных при последующем обновлении этого набора данных набора фрагментов не обновляется.If you create tilesets from a dataset, and then subsequently update that dataset, the tilesets will not be updated. Чтобы отразить изменения в наборе данных, необходимо создать новый набор фрагментов.To reflect changes in a dataset, you must create new tilesets. Аналогично, удаление набора фрагментов не влияет на набор данных.Similarly, if you delete a tileset, the dataset will not be affected.

Наборы состояний функцииFeature statesets

Наборы состояний функции — это коллекции динамических свойств (состояний), назначенных функциям набора данных, таким как комнаты или оборудование.Feature statesets are collections of dynamic properties (states) assigned to dataset features such as rooms or equipment. Примером состояния может служить температура или вместимость.An example of a state could be temperature or occupancy. Каждое состояние представляет собой пару "ключ-значение", содержащую имя свойства, значение и метку времени последнего обновления.Each state is a key/value pair containing the name of the property, the value, and the timestamp of the last update.

Служба состояний функции позволяет создавать наборы состояний функций для наборов данных и управлять ими.The Feature State service lets you create and manage a feature stateset for a dataset. Набор состояний определяется одним или несколькими состояниями .The stateset is defined by one or more states. С каждым признаком, например комнатой, может быть связано одно состояние.Each feature, such as a room, can have one state attached to it.

Значение каждого состояния в наборе состояний может обновляться или извлекаться устройствами Интернета вещей либо другими приложениями.The value of each state in a stateset can be updated or retrieved by IoT devices or other applications. Например, с помощью API обновления состояния признаков устройства, измеряющие использование площади, могут систематически публиковать данные об изменении состояния комнаты.For example, using the Feature State Update API, devices measuring space occupancy can systematically post the state change of a room.

Приложение может использовать набор состояний функции для динамической отрисовки признаков в здании в соответствии с их текущим состоянием и соответствующим стилем схемы.An application can use a feature stateset to dynamically render features in a facility according to their current state and respective map style. Дополнительные сведения об использовании наборов состояний функции стиля на схеме для отрисовки см. в разделе Модуль веб-пакета SDK для схем помещений.For more information on using feature statesets to style features in a rendering map, see Indoor Web SDK Module.

Примечание

Как и в случае с набором фрагментов, изменение набора данных не влияет на имеющийся набор состояний функции и удаление последнего не влияет на набор данных, к которому он присоединен.Like tilesets, changing a dataset does not affect the existing feature stateset and deleting a feature stateset will have no effect on the dataset to which it is attached.

Использование схем помещенийUsing indoor maps

Служба Render V2Render V2 service

Служба Azure Maps Render v2 — получение API плиток карты (Предварительная версия) расширено для поддержки создателя (Предварительная версия) тилесетс.The Azure Maps Render V2 service-Get Map Tile API (Preview) has been extended to support Creator (Preview) tilesets.

API получения фрагмента схемы службы Render V2 позволяет приложениям запрашивать наборы фрагментов.Render V2 service-Get Map State Tile API allows applications to request tilesets. Затем наборы фрагментов можно интегрировать в элемент управления схемой или пакет SDK.The tilesets can then be integrated into a map control or SDK. Пример элемента управления схемой, использующего службу Render V2, см. в разделе Модуль схем помещений.For an example of a map control that uses the Render V2 service, see Indoor Maps Module.

API-интерфейс Web Feature ServiceWeb Feature Service API

Наборы данных можно запрашивать с помощью API-интерфейса Web Feature Service (WFS).Datasets can be queried using the Web Feature Service (WFS) API. WFS соответствует признакам API Открытого геопространственного консорциума.WFS follows the Open Geospatial Consortium API Features. API-интерфейс WFS позволяет запрашивать функции в самом наборе данных.The WFS API lets you query features within the dataset itself. Например, WFS можно использовать для поиска всех конференц-залов среднего размера на конкретном этаже здания.For example, you can use WFS to find all mid-size meeting rooms of a given facility and floor level.

Модуль схем помещенийIndoor Maps module

Веб-пакет SDK Azure Maps включает в себя модуль схем помещений.The Azure Maps Web SDK includes the Indoor Maps module. Этот модуль предлагает расширенные функциональные возможности для библиотеки Map Control в Azure Maps.This module offers extended functionalities to the Azure Maps Map Control library. Модуль Maps визуализирует карты, созданные в окне автор (Предварительная версия).The Indoor Maps module renders indoor maps created in Creator (Preview). Он интегрирует мини-приложения, например средство выбора этажа, которое помогает пользователям визуализировать различные этажи.It integrates widgets such as floor picker, which helps users visualize the different floors.

Модуль схем помещений позволяет создавать веб-приложения, которые интегрируют данные схемы помещения в другие службы Azure Maps.The Indoor Maps module allows you to create web applications that integrate indoor map data with other Azure Maps services. В числе наиболее распространенных возможностей приложений добавление набора знаний схемы помещений с других карт, например дорожных, фотографических, погодных и транзитных.The most common application setups could include adding knowledge to indoor maps from other maps such as road, imagery, weather, and transit.

Модуль схем помещений также поддерживает динамическую настройку стиля схем.The Indoor Maps module also supports dynamic map styling. Пошаговое руководство по реализации динамической настройки стиля для набора состояний функции в приложении см. в разделе об использовании модуля схем помещений.For a step-by-step walk-through on how to implement feature stateset dynamic styling in an application, see How to Use the Indoor Map Module

Интеграция с Azure MapsAzure Maps integration

Начиная разрабатывать решения для схем помещений, можно определить способы интеграции имеющихся возможностей Azure Maps.As you begin to develop solutions for indoor maps, you can discover ways to integrate existing Azure Maps capabilities. Например, можно реализовать сценарии отслеживания ресурсов или обеспечения безопасности, используя API-интерфейс геозоны Azure Maps со схемами помещений Creator.For example, asset tracking or safety scenarios could be implemented by using the Azure Maps Geofence API with Creator indoor maps. С помощью API геозоны можно, например, определить входит работник в конкретные области помещения или выходит из них.The Geofence API could be used to determine, for example, whether a worker enters or leaves specific indoor areas. Дополнительные сведения о том, как подключить Azure Maps к данными телеметрии Интернета вещей, доступны здесь.For more information on how to connect Azure Maps with IoT telemetry is available here.

Обслуживание данныхData Maintenance

API списка, обновления и удаления Azure Maps Creator (Предварительная версия) позволяет перечислять, обновлять и удалять наборы данных, тилесетс и Feature статесетс.Azure Maps Creator (Preview) List, Update, and Delete API allows you to list, update, and delete your datasets, tilesets, and feature statesets.

Примечание

При каждом просмотре списка элементов и принятии решения об их удалении необходимо учитывать влияние этого действия на все зависимые API или приложения.Whenever you review a list of items and decide to delete them, you must consider the impact of that deletion on all dependent API or applications. Например, если необходимо удалить набор фрагментов, который в настоящее время используется приложением через API получения фрагмента схемы службы Render V2, его удаление приведет к сбою приложения при отрисовке данного набора фрагментов.For example, if you should delete a tileset that is currently being used by an application by means of the Render V2 - Get Map Tile API, deleting that tileset would result in an application failure to render that tileset.

Пример Обновление набора данныхExample: Updating a dataset

В следующем примере показано, как обновить набор данных, создать новый набор фрагментов и удалить старый.The following example shows you how to update a dataset, create a new tileset, and delete an old tileset.

  1. Выполните действия, описанные в разделах Отправка пакета рисунков и Преобразование пакета рисунков, чтобы отправить и преобразовать новый пакет рисунков.Follow steps in the Upload a Drawing package and Convert a Drawing package sections to upload and convert the new Drawing package.

  2. Используйте API создания набора данных, чтобы добавить преобразованные данные в существующий набор данных.Use the Dataset Create API to append the converted data to the existing dataset.

  3. Используйте API создания набора фрагментов, чтобы создать новый набор фрагментов из обновленного набора данных.Use the Tileset Create API to generate a new tileset out of the updated dataset. Сохраните новый идентификатор набора фрагментов для шага 4.Save the new tilesetId for step 4.

  4. Обновите идентификатор набора фрагментов в приложении, чтобы обеспечить визуализацию обновленных наборов данных кампуса.Update the tileset identifier in your application to enable the visualization of the updated campus dataset. Если старый набор фрагментов больше не используется, его можно удалить.If the old tileset is no longer in use, you can delete it.

Дальнейшие действияNext steps