Hub API v1

Operadores

Como identificar operadores de transporte e utilizar os seus dados operacionais.

O GO define um ID único para cada operador de transporte, que é utilizado em todas as outras estruturas de dados. Este endpoint devolve a informação pública de cada operador, assim como as funcionalidades que estão ativadas para cada um. Com esta informação é possível perceber quais são os operadores que estão incluídos na exportação combinada de GTFS ou que estão a utilizar o serviço de ETAs do GO.

Os IDs de cada operador são acompanhados também com um código (agency_code) que identifica cada operador noutros sistemas de informação, como por exemplo no sistema de bilhética APEX.

Estrutura de dados

No Hub, um operador é representado por um objeto JSON com as seguintes propriedades:

PropriedadeTipoDescrição
_idStringID único do operador.
codeStringCódigo do operador noutros sistemas de informação.
nameStringNome do operador.
website_urlStringURL do website.
fare_urlStringURL para informação de tarifas.
emailStringEmail de contacto público.
phoneStringContacto telefónico do operador.
primary_languageStringIdioma principal utilizado pelo operador.
timezoneStringFuso horário da operação.
servicesObjectServiços do GO Hub ativos para este operador.
services.eta_enabledBooleanIndica se estão a ser geradas estimativas de chegada em tempo real com base nas posições de veículos.
services.gtfs_enabledBooleanIndica se os planos deste operador estão a ser incluídos na exportação do GTFS global.
services.positions_enabledBooleanIndica se estão a ser publicadas posições de veículos em tempo real para este operador.
services.service_alerts_enabledBooleanIndica se estão a ser publicados alertas de serviço para este operador.

Endpoints disponíveis

Base path: https://go.tmlmobilidade.pt/hub/api

PathTipoDescrição
/v1/agenciesHubV1ApiAgencyTodos os operadores de transporte disponíveis no GO.

On this page