Solicitar dados de trânsito públicos em tempo real usando o serviço de mobilidade do Azure MapsRequest real-time public transit data using the Azure Maps Mobility Service

Este artigo mostra como usar o serviço de mobilidade do Azure Maps para solicitar dados de trânsito públicos em tempo real.This article shows you how to use Azure Maps Mobility Service to request real-time public transit data.

Neste artigo, você aprenderá a solicitar as próximas entradas em tempo real para todas as linhas que chegam em uma determinada paradaIn this article, you will learn how to request next real-time arrivals for all lines arriving at a given stop

Pré-requisitosPrerequisites

Primeiro, você precisa ter uma conta do Azure Maps e uma chave de assinatura para fazer chamadas para as APIs de trânsito público do Azure Maps.You first need to have an Azure Maps account and a subscription key to make any calls to the Azure Maps public transit APIs. Para obter informações, siga as instruções em criar uma conta para criar uma conta do Azure Maps.For information, follow instructions in Create an account to create an Azure Maps account. Siga as etapas em obter chave primária para obter a chave primária para sua conta.Follow the steps in get primary key to obtain the primary key for your account. Para obter mais informações sobre a autenticação nos Azure Mapas, confira Gerenciar a autenticação nos Azure Mapas.For more information on authentication in Azure Maps, see manage authentication in Azure Maps.

Este artigo usa o aplicativo Postman para criar chamadas REST.This article uses the Postman app to build REST calls. Você pode usar qualquer ambiente de desenvolvimento de API que você preferir.You can use any API development environment that you prefer.

Solicitar entradas em tempo real para uma paradaRequest real-time arrivals for a stop

Para solicitar dados de chegada em tempo real de uma parada de trânsito público em particular, você precisará fazer a solicitação para a API de entradas em tempo real do serviço de mobilidadedo Azure Maps.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. Você precisará de metroID e StopId para concluir a solicitação.You'll need the metroID and stopID to complete the request. Para saber mais sobre como solicitar esses parâmetros, consulte nosso guia sobre como solicitar rotas de trânsito públicas.To learn more about how to request these parameters, see our guide on how to request public transit routes.

Vamos usar "522" como nossa ID metro, que é a ID do metro para a área "Seattle – Tacoma – Bellevue, WA".Let's use "522" as our metro ID, which is the metro ID for the "Seattle–Tacoma–Bellevue, WA" area. Use "522---2060603" como a ID de parada, essa parada de barramento está em "ne 24 St & 162nd ave ne, Bellevue WA".Use "522---2060603" as the stop ID, this bus stop is at "Ne 24th St & 162nd Ave Ne, Bellevue WA". Para solicitar os próximos cinco dados de chegada em tempo real, para todas as próximas entradas ao vivo neste ponto de interrupção, conclua as seguintes etapas:To request the next five real-time arrivals data, for all next live arrivals at this stop, complete the following steps:

  1. Abra o aplicativo do postmaster e vamos criar uma coleção para armazenar as solicitações.Open the Postman app, and let's create a collection to store the requests. Próximo à parte superior do aplicativo Postman, selecione Novo.Near the top of the Postman app, select New. Na janela Criar, selecione Coleção.In the Create New window, select Collection. Nomeie a coleção e selecione o botão Criar.Name the collection and select the Create button.

  2. Para criar a solicitação, selecione Novo outra vez.To create the request, select New again. Na janela Criar, selecione Solicitação.In the Create New window, select Request. Insira um Nome de solicitação para a solicitação.Enter a Request name for the request. Selecione a coleção que você criou na etapa anterior, como o local no qual salvar a solicitação.Select the collection you created in the previous step, as the location in which to save the request. Em seguida, selecione Salvar.Then, select Save.

    Criar uma solicitação no postmaster

  3. Selecione o método http Get na guia Construtor e insira a URL a seguir para criar uma solicitação get.Select the GET HTTP method on the builder tab and enter the following URL to create a GET request. Substitua {subscription-key} , por sua chave primária do 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. Após uma solicitação bem-sucedida, você receberá a resposta a seguir.After a successful request, you'll receive the following response. Observe que o parâmetro ' ScheduleType ' define se o tempo de chegada estimado é baseado em dados em tempo real ou estáticos.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"
                }
            }
        ]
    }
    

Próximas etapasNext steps

Saiba como solicitar dados de trânsito usando o serviço de mobilidade:Learn how to request transit data using Mobility Service:

Explore a documentação da API do serviço de mobilidade do Azure Maps:Explore the Azure Maps Mobility Service API documentation: