Запрос общедоступных транзитных данных в реальном времени с помощью Azure Maps служб Mobility Services (Предварительная версия)Request real-time public transit data using the 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.

В этой статье показано, как использовать службы Mobility Azure Maps для запроса общедоступных транзитных данных в режиме реального времени.This article shows you how to use Azure Maps Mobility services to request real-time public transit data.

В этой статье вы узнаете, как запросить следующие поступления в реальном времени для всех строк, поступающих на заданную точку.In this article, you will learn how to request next real-time arrivals for all lines arriving at a given stop

Предварительные условияPrerequisites

Сначала необходимо иметь учетную запись Azure Maps и ключ подписки, чтобы выполнять вызовы Azure Maps общедоступных транзитных API.You first need to have an Azure Maps account and a subscription key to make any calls to the Azure Maps public transit APIs. Для получения сведений следуйте инструкциям в разделе Создание учетной записи для создания учетной записи Azure Maps.For information, follow instructions in Create an account to create an Azure Maps account. Выполните действия, описанные в разделе Получение первичного ключа , чтобы получить первичный ключ для вашей учетной записи.Follow the steps in get primary key to obtain the primary key for your account. Дополнительные сведения о проверке подлинности в Azure Maps см. в этой статье.For more information on authentication in Azure Maps, see manage authentication in Azure Maps.

В этой статье для создания вызовов REST используется приложение Postman.This article uses the Postman app to build REST calls. Вы можете использовать любую среду разработки API.You can use any API development environment that you prefer.

Запрос прибытия в режиме реального времени для завершенияRequest real-time arrivals for a stop

Чтобы запросить данные о поступлении конкретного открытого транзитного пути в режиме реального времени, необходимо выполнить запрос к API прибытия в режиме реального времени в службе Azure Maps Mobility Service (Предварительная версия).In order to request real-time arrivals data of a particular public transit stop, you'll need to make request to the Real-time Arrivals API of the Azure Maps Mobility Service (Preview). Для выполнения запроса потребуются Метроид и стопид .You'll need the metroID and stopID to complete the request. Чтобы узнать больше о том, как запросить эти параметры, ознакомьтесь с нашим руководством по запросу общих транзитных маршрутов.To learn more about how to request these parameters, see our guide on how to request public transit routes.

Давайте будем использовать "522" в качестве идентификатора Metro, который является ИДЕНТИФИКАТОРом Metro для области "Сиэтл – Tacoma – Бельвью, WA".Let's use "522" as our metro ID, which is the metro ID for the "Seattle–Tacoma–Bellevue, WA" area. В качестве идентификатора завершения используйте "522---2060603". Эта шина останавливается в "NE 24 St & 162nd Ave NE, Бельвью WA".Use "522---2060603" as the stop ID, this bus stop is at "Ne 24th St & 162nd Ave Ne, Bellevue WA". Чтобы запросить следующие пять данных о поступлении в реальном времени, для следующих прямых появления при этой ошибке выполните следующие действия.To request the next five real-time arrivals data, for all next live arrivals at this stop, complete the following steps:

  1. Откройте приложение POST и создадим коллекцию для хранения запросов.Open the Postman app, and let's create a collection to store the requests. В верхней части приложения Postman выберите элемент Создать.Near the top of the Postman app, select New. В окне Create New (Создание) выберите Collection (Коллекция).In the Create New window, select Collection. Присвойте имя коллекции и нажмите кнопку Создать.Name the collection and select the Create button.

  2. Чтобы создать запрос, нажмите кнопку Создать еще раз.To create the request, select New again. В окне Create New (Создание) выберите Request (Запрос).In the Create New window, select Request. Введите Имя запроса для запроса.Enter a Request name for the request. Выберите коллекцию, созданную на предыдущем шаге, в качестве расположения для сохранения запроса.Select the collection you created in the previous step, as the location in which to save the request. Затем нажмите кнопку Сохранить.Then, select Save.

    Создание запроса в POST

  3. Выберите метод получения HTTP на вкладке Построитель и введите следующий URL-адрес для создания запроса GET.Select the GET HTTP method on the builder tab and enter the following URL to create a GET request. Замените на {subscription-key} Azure Maps первичный ключ.Replace {subscription-key}, with your Azure Maps primary key.

    https://atlas.microsoft.com/mobility/realtime/arrivals/json?subscription-key={subscription-key}&api-version=1.0&metroId=522&query=522---2060603&transitType=bus
    
  4. После успешного выполнения запроса вы получите следующий ответ.After a successful request, you'll receive the following response. Обратите внимание, что параметр "scheduleType" определяет, основывается ли предполагаемое время прибытия на основе данных в режиме реального времени или статических.Notice that parameter 'scheduleType' defines whether the estimated arrival time is based on real-time or static data.

    {
        "results": [
            {
                "arrivalMinutes": 8,
                "scheduleType": "realTime",
                "patternId": "522---4143196",
                "line": {
                    "lineId": "522---3760143",
                    "lineGroupId": "522---666077",
                    "direction": "backward",
                    "agencyId": "522---5872",
                    "agencyName": "Metro Transit",
                    "lineNumber": "249",
                    "lineDestination": "South Bellevue S Kirkland P&R",
                    "transitType": "Bus"
                },
                "stop": {
                    "stopId": "522---2060603",
                    "stopKey": "71300",
                    "stopName": "NE 24th St & 162nd Ave NE",
                    "stopCode": "71300",
                    "position": {
                        "latitude": 47.631504,
                        "longitude": -122.125275
                    },
                    "mainTransitType": "Bus",
                    "mainAgencyId": "522---5872",
                    "mainAgencyName": "Metro Transit"
                }
            },
            {
                "arrivalMinutes": 25,
                "scheduleType": "realTime",
                "patternId": "522---3510227",
                "line": {
                    "lineId": "522---2756599",
                    "lineGroupId": "522---666063",
                    "direction": "forward",
                    "agencyId": "522---5872",
                    "agencyName": "Metro Transit",
                    "lineNumber": "226",
                    "lineDestination": "Bellevue Transit Center Crossroads",
                    "transitType": "Bus"
                },
                "stop": {
                    "stopId": "522---2060603",
                    "stopKey": "71300",
                    "stopName": "NE 24th St & 162nd Ave NE",
                    "stopCode": "71300",
                    "position": {
                        "latitude": 47.631504,
                        "longitude": -122.125275
                    },
                    "mainTransitType": "Bus",
                    "mainAgencyId": "522---5872",
                    "mainAgencyName": "Metro Transit"
                }
            }
        ]
    }
    

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

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

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