Структуры данных в службах Azure Maps Mobility Services (Предварительная версия)Data structures in Azure Maps Mobility services (Preview)

Важно!

Службы Mobility Azure Maps в настоящее время доступны в общедоступной предварительной версии.Azure Maps Mobility 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.

В этой статье описывается понятие области Metro в Azure Maps служб Mobility Services.This article introduces the concept of Metro Area in Azure Maps Mobility services. Мы обсудим некоторые из общих полей, возвращаемых при запросе этой службы о прекращении передачи и строках.We discuss some of common fields that are returned when this service is queried for public transit stops and lines. Мы рекомендуем ознакомиться с этой статьей перед началом разработки с помощью API-интерфейсов служб Mobility Services.We recommend reading this article before developing with the Mobility services APIs.

Область MetroMetro area

Данные служб Mobility Services (Предварительная версия) группируются по поддерживаемым областям метро.Mobility services (Preview) data is grouped by supported metro areas. Области Metro не следуют границам города.Metro areas don't follow city boundaries. В области Metro может содержаться несколько городов, заполненный город и окружающие города.A metro area can contain multiple cities, densely populated city, and surrounding cities. На самом деле, страна или регион могут быть одной областью метро.In fact, a country/region can be one metro area.

metroID— Это идентификатор области метро, который можно использовать для вызова API получения сведений о области Metro.The metroID is a metro area's ID that can be used to call the Get Metro Area Info API. Используйте Azure Maps "" Get Metro "API для запроса типов транзитного склада, транзитных агентств, активных оповещений и дополнительных сведений о выбранном Metro.Use Azure Maps' "Get Metro" API to request transit types, transit agencies, active alerts, and additional details for the chosen metro. Вы также можете запросить поддерживаемые области Metro и Метроидс.You can also request the supported metro areas and metroIDs. Идентификаторы областей Metro могут изменяться.Metro area IDs are subject to change.

Метроид: 522 Имя: Сиэтл-Tacoma-БельвьюmetroID: 522 Name: Seattle-Tacoma-Bellevue

Сиэтл-Metro-Area

Идентификаторы завершенияStop IDs

На транзитные остановки могут ссылаться два типа идентификаторов: идентификатор гфтс и идентификатор остановки Azure Maps.Transit stops can be referred to by two types of IDs, the General Transit Feed Specification (GFTS) ID and the Azure Maps stop ID. Идентификатор ГФТС называется Стопкэй, а Azure Maps ИДЕНТИФИКАТОРом останавливает называется Стопид.The GFTS ID is referred to as the stopKey and the Azure Maps stop ID is referred to as stopID. При частом обращении к транзиту рекомендуется использовать идентификатор остановки Azure Maps.When frequently referring to transit stops, you're encouraged to use the Azure Maps stop ID. Стопид является более стабильным и, скорее всего, останется тем же, пока существует физическая точка.stopID is more stable and likely to stay the same as long as the physical stop exists. Идентификатор ГТФС останавливает обновляться чаще.The GTFS stop ID is updated more often. Например, можно обновить идентификатор ГТФС в запросе поставщика ГТФС или при освобождении новой версии ГТФС.For example, GTFS stop ID can be updated per the GTFS provider request or when a new GTFS version is released. Несмотря на то, что физическая точка прекращения не имела изменений, идентификатор завершения ГТФС может измениться.Although the physical stop had no change, the GTFS stop ID may change.

Чтобы начать, можно запросить находящиеся в ближайшем транзите пути, используя функцию получения ближайших API транзитного пути.To start, you can request nearby transit stops using Get Nearby Transit API.

Группы линий и линииLine Groups and Lines

Службы Mobility Service (Предварительная версия) используют параллельную модель данных для линий и групп строк.Mobility services (Preview) use a parallel data model for Lines and Line Groups. Эта модель используется для повышения эффективности изменений, наследуемых от гтфс маршрутов и данных о поездках.This model is used to better deal with changes inherited from GTFS routes and the trips data.

Группы строкLine Groups

Группа строк — это сущность, которая объединяет все строки, логически входящие в одну и ту же группу.A Line Group is an entity, which groups together all lines that are logically part of the same group. Как правило, группа строк содержит две строки: одну от точки A к B, а другая — от точки B до A. Обе строки будут принадлежать одному открытому агентству транспорта и имеют одинаковый номер строки.Usually, a line group contains two lines, one from point A to B, and the other returning from point B to A. Both lines would belong to the same Public Transport agency and have the same line number. Однако могут возникнуть ситуации, в которых группа строк содержит более двух строк или только одну строку внутри нее.However, there may be cases in which a line group has more than two lines or only a single line within it.

ЛинииLines

Как упоминалось выше, каждая группа строк состоит из набора строк.As discussed above, each line group is composed of a set of lines. Каждая группа строк состоит из двух строк, и каждая строка описывает направление.Each line group is composed of two lines, and each line describes a direction. Однако бывают случаи, в которых дополнительные строки образуют группу строк.However, there are cases in which more lines compose a line group. Например, есть строка, которая иногда рассматривает определенное окружение, а иногда нет.For example, there's a line that sometimes detours through a certain neighborhood and sometimes doesn't. В обоих случаях он работает под тем же номером строки.In both cases, it operates under the same line number. Кроме того, группа строк может состоять из одной строки.Also a line group can be composed of a single line. Круглая линия с одним направлением — это группа «водо» с одной линией.A circular line with a single direction is a ling group with one line.

Для начала можно запросить группы строк с помощью API получения транзитной строки.To begin, you can request line groups by using the Get Transit Line API.

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

Узнайте, как запросить транзитные данные с помощью служб Mobility Services (Предварительная версия):Learn how to request transit data using Mobility services (Preview):

Узнайте, как запрашивать данные в режиме реального времени с помощью служб Mobility Services (Предварительная версия):Learn how to request real-time data using Mobility services (Preview):

Ознакомьтесь с документацией по API Azure Maps Mobility Services (Предварительная версия)Explore the Azure Maps Mobility services (Preview) API documentation