- Recurso: TransitObject
- PassengerType
- TicketStatus
- ConcessionCategory
- TicketRestrictions
- PurchaseDetails
- TicketCost
- TicketLeg
- TicketSeat
- FareClass
- TripType
- ActivationStatus
- Estado
- DeviceContext
- Métodos
Recurso: TransitObject
Representação JSON |
---|
{ "classReference": { object ( |
Campos | |
---|---|
classReference |
Uma cópia dos campos herdados da classe pai. Esses campos são recuperados durante um GET. |
ticketNumber |
O número do ingresso. Esse é um identificador exclusivo da passagem no sistema do operador de transporte público. |
passengerType |
O número de passageiros. |
passengerNames |
Os nomes dos passageiros a que a passagem é atribuída. O campo |
tripId |
Esse ID é usado para agrupar passagens, caso o usuário tenha salvo várias passagens para a mesma viagem. |
ticketStatus |
O status do tíquete. Para estados que afetam a exibição, use o campo |
customTicketStatus |
Um status personalizado a ser usado como valor do status da passagem quando |
concessionCategory |
A categoria de concessão da passagem. |
customConcessionCategory |
Uma categoria de concessão personalizada a ser usada quando |
ticketRestrictions |
Informações sobre os tipos de restrições ao uso do ingresso. Por exemplo, quais dias da semana ele precisa ser usado ou quais trajetos podem ser feitos. |
purchaseDetails |
Detalhes da compra desta passagem. |
ticketLeg |
Uma única passagem contém informações de partida e chegada, além de informações sobre embarque e assento. Se mais de um trecho for especificado, use o campo |
ticketLegs[] |
Cada passagem pode conter um ou mais trechos. Cada trecho contém informações de partida e chegada, além de informações sobre embarque e assento. Se apenas um trecho for especificado, use o campo |
hexBackgroundColor |
A cor de fundo do cartão. Se não for definida, será usada a cor dominante da imagem principal e, se nenhuma imagem principal estiver definida, a cor predominante do logotipo será usada. O formato é #rrggbb, em que rrggbb é um trio RGB hexadecimal, como |
tripType |
Obrigatório. O tipo de viagem representado por este objeto de transporte público. Usado para determinar o título do cartão e/ou qual símbolo usar entre a origem e o destino. |
id |
Obrigatório. O identificador exclusivo de um objeto. Esse ID precisa ser exclusivo entre todos os objetos de um emissor. Esse valor precisa seguir o formato issuer ID.identifier, em que o primeiro é emitido pelo Google e o último é escolhido por você. O identificador exclusivo precisa incluir apenas caracteres alfanuméricos, ".", "_" ou "-". |
classId |
Obrigatório. A classe associada a este objeto. A classe precisa ser do mesmo tipo que este objeto, já deve existir e ser aprovada. Os IDs de classe precisam seguir o formato issuer ID.identifier, em que o primeiro é emitido pelo Google e o último é escolhido por você. |
version |
Suspenso |
state |
Obrigatório. O estado do objeto. Esse campo é usado para determinar como um objeto é exibido no app. Por exemplo, um objeto |
barcode |
O tipo e o valor do código de barras. |
messages[] |
Uma matriz de mensagens exibidas no app. Todos os usuários deste objeto vão receber as mensagens associadas. O número máximo desses campos é 10. |
validTimeInterval |
O período em que este objeto será |
locations[] |
Observação: no momento, este campo não é suportado para acionar notificações geográficas. |
hasUsers |
Indica se o objeto tem usuários. Este campo é definido pela plataforma. |
smartTapRedemptionValue |
O valor que será transmitido para um terminal certificado pelo Toque inteligente por NFC para esse objeto. Os campos no nível da turma |
hasLinkedDevice |
Indica se esse objeto está vinculado a um único dispositivo no momento. Esse campo é definido pela plataforma quando um usuário salva o objeto, vinculando-o ao dispositivo. Destinado ao uso por parceiros selecionados. Entre em contato com o suporte para mais informações. |
disableExpirationNotification |
Indica se as notificações precisam ser suprimidas explicitamente. Se esse campo for definido como verdadeiro, independentemente do campo No momento, isso só pode ser definido para ofertas. |
infoModuleData |
Obsoleto. Use textModulesData. |
imageModulesData[] |
Dados do módulo de imagem. O número máximo de campos exibidos é 1 no nível do objeto e 1 no nível do objeto da classe. |
textModulesData[] |
Dados do módulo de texto. Se os dados do módulo de texto também estiverem definidos na classe, ambos serão exibidos. O número máximo desses campos exibidos é 10 para o objeto e 10 para a classe. |
linksModuleData |
Dados do módulo de links. Se os dados do módulo de links também estiverem definidos na classe, ambos serão exibidos. |
appLinkData |
Link opcional do app ou site que vai aparecer como um botão na frente do cartão. Se AppLinkData for fornecido para o objeto somente de classe correspondente, AppLinkData será exibido. |
activationStatus |
O status de ativação do objeto. Obrigatório se a classe tiver |
rotatingBarcode |
O tipo e o valor do código de barras rotativo. |
deviceContext |
Contexto do dispositivo associado ao objeto. |
heroImage |
Imagem do banner opcional exibida na parte da frente do cartão. Se nenhuma estiver presente, a imagem principal da turma, se houver, será exibida. Se a imagem principal da turma também não estiver presente, nada será exibido. |
groupingInfo |
Informações que controlam como os cartões são agrupados. |
passConstraints |
Restrições de transmissão para o objeto. Inclui a limitação de comportamentos de NFC e captura de tela. |
saveRestrictions |
Restrições no objeto que precisam ser verificadas antes que o usuário tente salvar o cartão. Essas restrições serão aplicadas apenas durante o horário de funcionamento. Se as restrições mudarem depois que o usuário salvar o cartão, as novas restrições não serão aplicadas a um cartão já salvo. |
PassengerType
Enums | |
---|---|
PASSENGER_TYPE_UNSPECIFIED |
|
SINGLE_PASSENGER |
|
singlePassenger |
Alias legado de |
MULTIPLE_PASSENGERS |
|
multiplePassengers |
Alias legado de |
TicketStatus
Enums | |
---|---|
TICKET_STATUS_UNSPECIFIED |
|
USED |
|
used |
Alias legado de |
REFUNDED |
|
refunded |
Alias legado de |
EXCHANGED |
|
exchanged |
Alias legado de |
ConcessionCategory
Enums | |
---|---|
CONCESSION_CATEGORY_UNSPECIFIED |
|
ADULT |
|
adult |
Alias legado de |
CHILD |
|
child |
Alias legado de |
SENIOR |
|
senior |
Alias legado de |
TicketRestrictions
Representação JSON |
---|
{ "routeRestrictions": { object ( |
Campos | |
---|---|
routeRestrictions |
Restrições sobre as rotas que podem ser seguidas. Por exemplo, pode ser a string "Somente trens reservados entre países". |
routeRestrictionsDetails |
Mais detalhes sobre o |
timeRestrictions |
Restrições sobre os horários em que este ingresso pode ser usado. |
otherRestrictions |
Restrições extras que não se enquadram na "rota" ou "tempo" categorias. |
PurchaseDetails
Representação JSON |
---|
{
"purchaseReceiptNumber": string,
"purchaseDateTime": string,
"accountId": string,
"confirmationCode": string,
"ticketCost": {
object ( |
Campos | |
---|---|
purchaseReceiptNumber |
Número/identificador do comprovante para rastrear a compra da passagem pelo órgão que a vendeu. |
purchaseDateTime |
A data/hora da compra da passagem. É uma data/hora em formato estendido ISO 8601, com ou sem deslocamento. A hora pode ser especificada com precisão de nanossegundos. Os deslocamentos podem ser especificados com precisão de segundos, mesmo que os segundos de deslocamento não façam parte da norma ISO 8601. Exemplo:
Sem as informações de compensação, alguns recursos avançados podem não estar disponíveis. |
accountId |
ID da conta usada para comprar a passagem. |
confirmationCode |
O código de confirmação da compra. Pode ser o mesmo para várias passagens diferentes e é usado para agrupar passagens. |
ticketCost |
O custo da passagem. |
TicketCost
Representação JSON |
---|
{ "faceValue": { object ( |
Campos | |
---|---|
faceValue |
O valor nominal do ingresso. |
purchasePrice |
O preço de compra real da passagem, após tributos e/ou descontos. |
discountMessage |
Uma mensagem descrevendo qualquer tipo de desconto aplicado. |
TicketLeg
Representação JSON |
---|
{ "originStationCode": string, "originName": { object ( |
Campos | |
---|---|
originStationCode |
O código da estação de origem. Isso será necessário se |
originName |
O nome da estação de origem. Isso será necessário se |
destinationStationCode |
O código da estação de destino. |
destinationName |
O nome do destino. |
departureDateTime |
A data/hora de partida. Obrigatório se não houver um intervalo de tempo de validade definido no objeto de transporte público. É uma data/hora em formato estendido ISO 8601, com ou sem deslocamento. A hora pode ser especificada com precisão de nanossegundos. Os deslocamentos podem ser especificados com precisão de segundos, mesmo que os segundos de deslocamento não façam parte da norma ISO 8601. Exemplo:
A parte da data/hora sem o deslocamento é considerada a "data/hora local". Deve ser a data/hora local na estação de origem. Por exemplo, se a partida ocorrer na 20a hora de 5 de junho de 2018 na estação de origem, a parte de data/hora local precisará ser Sem as informações de compensação, alguns recursos avançados podem não estar disponíveis. |
arrivalDateTime |
A data/hora de chegada. É uma data/hora em formato estendido ISO 8601, com ou sem deslocamento. A hora pode ser especificada com precisão de nanossegundos. Os deslocamentos podem ser especificados com precisão de segundos, mesmo que os segundos de deslocamento não façam parte da norma ISO 8601. Exemplo:
A parte da data/hora sem o deslocamento é considerada a "data/hora local". É a data/hora local na estação de destino. Por exemplo, se o evento ocorrer na 20a hora de 5 de junho de 2018 na estação de destino, a parte de data/hora local deverá ser Sem as informações de compensação, alguns recursos avançados podem não estar disponíveis. |
fareName |
Breve descrição/nome da tarifa deste trecho da viagem. Por exemplo, "Uso único quando quiser". |
carriage |
O nome/número do trem ou navio em que o passageiro precisa embarcar. |
platform |
A plataforma ou portão em que o passageiro pode embarcar no transporte. |
zone |
A zona de embarque dentro da plataforma. |
ticketSeat |
O assento reservado para os passageiros. Se for necessário especificar mais de um assento, use o campo |
ticketSeats[] |
O assento reservado para os passageiros. Se apenas um assento for especificado, use o campo |
transitOperatorName |
O nome do operador de transporte público que está operando este trecho de uma viagem. |
transitTerminusName |
Estação terminal ou destino do trem/ônibus/etc. |
TicketSeat
Representação JSON |
---|
{ "fareClass": enum ( |
Campos | |
---|---|
fareClass |
A classe de tarifa do assento da passagem. |
customFareClass |
Uma classe de tarifa de cliente a ser usada se nenhum |
coach |
O identificador do vagão ou ônibus em que o assento da passagem está localizado. Por exemplo: "10" |
seat |
O identificador de onde o assento da passagem está localizado. Por exemplo: "42". Se não houver um identificador específico, use |
seatAssignment |
A atribuição do assento do passageiro. Por exemplo: "sem assento específico". Para ser usado quando não houver um identificador específico para usar em |
FareClass
Enums | |
---|---|
FARE_CLASS_UNSPECIFIED |
|
ECONOMY |
|
economy |
Alias legado de |
FIRST |
|
first |
Alias legado de |
BUSINESS |
|
business |
Alias legado de |
TripType
Enums | |
---|---|
TRIP_TYPE_UNSPECIFIED |
|
ROUND_TRIP |
|
roundTrip |
Alias legado de |
ONE_WAY |
|
oneWay |
Alias legado de |
ActivationStatus
O status de ativação do objeto. Esse campo inclui o status de ativação se houver suporte para isso.
Representação JSON |
---|
{
"state": enum ( |
Campos | |
---|---|
state |
|
Estado
Enums | |
---|---|
UNKNOWN_STATE |
|
NOT_ACTIVATED |
Não ativado, este é o status padrão |
not_activated |
Alias legado de |
ACTIVATED |
Ativada em |
activated |
Alias legado de |
DeviceContext
Contexto do dispositivo associado ao objeto.
Representação JSON |
---|
{ "deviceToken": string } |
Campos | |
---|---|
deviceToken |
Se definido, as informações de resgate só serão retornadas ao dispositivo especificado após a ativação do objeto. Ele não deve ser usado como um identificador estável para rastrear o dispositivo de um usuário. Ele pode mudar em diferentes cartões para o mesmo dispositivo ou até mesmo em diferentes ativações para o mesmo dispositivo. Ao definir essa opção, os autores da chamada também precisam definir hasLinkedDevice no objeto que está sendo ativado. |
Métodos |
|
---|---|
|
Adiciona uma mensagem ao objeto de transporte público indicado pelo ID de objeto fornecido. |
|
Retorna o objeto de transporte público com o código de objeto fornecido. |
|
Insere um objeto de transporte público com o código e as propriedades fornecidos. |
|
Retorna uma lista de todos os objetos de transporte público de um determinado ID de emissor. |
|
Atualiza o objeto de transporte público indicado pelo ID de objeto fornecido. |
|
Atualiza o objeto de transporte público indicado pelo ID de objeto fornecido. |