Estruturas de dados no serviço de mobilidade do Azure MapsData structures in Azure Maps Mobility Service

Este artigo apresenta o conceito de área de metrô no serviço de mobilidade do Azure Maps.This article introduces the concept of Metro Area in Azure Maps Mobility Service. Discutiremos alguns campos comuns que são retornados quando esse serviço é consultado para interrupções e linhas de trânsito públicos.We discuss some of common fields that are returned when this service is queried for public transit stops and lines. É recomendável ler este artigo antes de desenvolver com as APIs do serviço de mobilidade.We recommend reading this article before developing with the Mobility Service APIs.

Área de metrôMetro area

Os dados do serviço de mobilidade são agrupados por áreas de metrô com suporte.Mobility Service data is grouped by supported metro areas. Áreas de metrô não seguem limites de cidade.Metro areas don't follow city boundaries. Uma área de metrô pode conter várias cidades, uma cidade com alta densidade e cidades ao redor.A metro area can contain multiple cities, densely populated city, and surrounding cities. Na verdade, um país/região pode ser uma área de metrô.In fact, a country/region can be one metro area.

O metroID é uma ID da área de metrô que pode ser usada para chamar a API obter informações da área de metrô.The metroID is a metro area's ID that can be used to call the Get Metro Area Info API. Use a API "Get metro" do Azure Maps para solicitar tipos de trânsito, agências de trânsito, alertas ativos e detalhes adicionais para o metro escolhido.Use Azure Maps' "Get Metro" API to request transit types, transit agencies, active alerts, and additional details for the chosen metro. Você também pode solicitar as áreas de metrô e metroIDs com suporte.You can also request the supported metro areas and metroIDs. As IDs de área de metrô estão sujeitas a alterações.Metro area IDs are subject to change.

metroID: 522 nome: Seattle-Tacoma-BellevuemetroID: 522 Name: Seattle-Tacoma-Bellevue

Seattle – área de metrô

Parar IDsStop IDs

As interrupções de trânsito podem ser referenciadas por dois tipos de IDs, a ID de GFTS (especificação de feed de trânsito geral) e a ID de parada do 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. A ID de GFTS é conhecida como stopKey e a ID de parada do Azure Maps é referida como stopid.The GFTS ID is referred to as the stopKey and the Azure Maps stop ID is referred to as stopID. Quando se referirem a um trânsito com frequência, você será incentivado a usar a ID de parada do Azure Maps.When frequently referring to transit stops, you're encouraged to use the Azure Maps stop ID. StopId é mais estável e provavelmente permanecerá o mesmo, desde que a parada física exista.stopID is more stable and likely to stay the same as long as the physical stop exists. A ID de parada GTFS é atualizada com mais frequência.The GTFS stop ID is updated more often. Por exemplo, GTFS Stop ID pode ser atualizado de acordo com a solicitação do provedor GTFS ou quando uma nova versão do GTFS é liberada.For example, GTFS stop ID can be updated per the GTFS provider request or when a new GTFS version is released. Embora a parada física não tenha sido alterada, a ID de parada GTFS pode ser alterada.Although the physical stop had no change, the GTFS stop ID may change.

Para começar, você pode solicitar que o trânsito próximo seja interrompido usando a API de trânsito próximo.To start, you can request nearby transit stops using Get Nearby Transit API.

Linhas e grupos de linhaLine Groups and Lines

O serviço de mobilidade usa um modelo de dados paralelo para linhas e grupos de linhas.Mobility Service uses a parallel data model for Lines and Line Groups. Esse modelo é usado para lidar melhor com as alterações herdadas das rotas GTFS e dos dados de viagens.This model is used to better deal with changes inherited from GTFS routes and the trips data.

Grupos de linhasLine Groups

Um grupo de linhas é uma entidade, que agrupa todas as linhas que são logicamente parte do mesmo grupo.A Line Group is an entity, which groups together all lines that are logically part of the same group. Normalmente, um grupo de linhas contém duas linhas, uma de ponto a a B e a outra retornando do ponto B para um. Ambas as linhas pertencem à mesma agência de transporte público e têm o mesmo número de linha.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. No entanto, pode haver casos em que um grupo de linhas tem mais de duas linhas ou apenas uma única linha dentro dela.However, there may be cases in which a line group has more than two lines or only a single line within it.

LinhasLines

Conforme discutido acima, cada grupo de linhas é composto por um conjunto de linhas.As discussed above, each line group is composed of a set of lines. Cada grupo de linhas é composto de duas linhas e cada linha descreve uma direção.Each line group is composed of two lines, and each line describes a direction. No entanto, há casos em que mais linhas compõem um grupo de linhas.However, there are cases in which more lines compose a line group. Por exemplo, há uma linha que às vezes faz uma despasseio por uma determinada vizinhança e, às vezes, não.For example, there's a line that sometimes detours through a certain neighborhood and sometimes doesn't. Em ambos os casos, ele opera com o mesmo número de linha.In both cases, it operates under the same line number. Além disso, um grupo de linhas pode ser composto por uma única linha.Also a line group can be composed of a single line. Uma linha circular com uma única direção é um grupo de Ling com uma linha.A circular line with a single direction is a ling group with one line.

Para começar, você pode solicitar grupos de linhas usando a API obter linha de trânsito.To begin, you can request line groups by using the Get Transit Line API.

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:

Saiba como solicitar dados em tempo real usando o serviço de mobilidade:Learn how to request real-time data using Mobility Service:

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