- Kaynak: TransitObject
- PassengerType
- TicketStatus
- ConcessionCategory
- TicketRestrictions
- PurchaseDetails
- TicketCost
- TicketLeg
- TicketSeat
- FareClass
- TripType
- ActivationStatus
- Durum
- DeviceContext
- Yöntemler
Kaynak: TransitObject
JSON gösterimi |
---|
{ "classReference": { object ( |
Alanlar | |
---|---|
classReference |
Üst sınıfın devralınan alanlarının bir kopyası. Bu alanlar GET işlemi sırasında alınır. |
ticketNumber |
Bilet numarası. Bu, toplu taşıma operatörünün sistemindeki bilete ait benzersiz bir tanımlayıcıdır. |
passengerType |
Yolcu sayısı. |
passengerNames |
Biletin atandığı yolcuların adları. Yukarıdaki |
tripId |
Bu kimlik, kullanıcı aynı seyahat için birden fazla bilet kaydettiyse biletleri gruplandırmak için kullanılır. |
ticketStatus |
Bilet durumu. Ekranı etkileyen eyaletler için bunun yerine |
customTicketStatus |
|
concessionCategory |
Bilet için ayrıcalık kategorisi. |
customConcessionCategory |
|
ticketRestrictions |
Bu destek kaydının kullanımıyla ilgili kısıtlamalar hakkında bilgi. Örneğin, haftanın hangi günlerinde kullanılması gerektiği veya hangi rotalara izin verildiği. |
purchaseDetails |
Bu biletle ilgili satın alma bilgileri. |
ticketLeg |
Tek bilet ayağı, biniş ve oturma bilgilerinin yanı sıra kalkış ve varış bilgilerini içerir. Birden fazla bacak belirtilmelidir. Bunun yerine |
ticketLegs[] |
Her bilet bir veya daha fazla ayak içerebilir. Her bir bölümde, biniş ve oturma bilgilerinin yanı sıra kalkış ve varış bilgileri yer alır. Yalnızca tek bir bacak belirtilecekse bunun yerine |
hexBackgroundColor |
Kartın arka plan rengi. Ayarlanmazsa hero resmin baskın rengi kullanılır ve hero resim ayarlanmamışsa logoda baskın renk kullanılır. Biçim, rrggbb. sıradadır; burada rrggbb, onaltılık bir RGB üçlüsüdür (ör. |
tripType |
Zorunlu. Bu toplu taşıma nesnesinin temsil ettiği gezi türü. Kalkış ve varış noktaları arasında geçişin başlığını ve/veya hangi sembolün kullanılacağını belirlemek için kullanılır. |
id |
Zorunlu. Bir nesnenin benzersiz tanımlayıcısıdır. Bu kimlik, bir verenin tüm nesneleri genelinde benzersiz olmalıdır. Bu değer issuer ID biçiminde olmalıdır.identifier: İlk sertifika Google tarafından verilir, ikincisini siz seçersiniz. Benzersiz tanımlayıcı sadece alfanümerik karakterler, '.', '_' veya '-' içermelidir. |
classId |
Zorunlu. Bu nesneyle ilişkilendirilen sınıf. Sınıf bu nesne ile aynı türde olmalı, hâlihazırda mevcut olmalı ve onaylanmalıdır. Sınıf kimlikleri issuer ID biçiminde olmalıdır.identifier: İlk sertifika Google tarafından verilir, ikincisini siz seçersiniz. |
version |
Kullanımdan kaldırıldı |
state |
Zorunlu. Nesnenin durumu. Bu alan, bir nesnenin uygulamada nasıl görüntüleneceğini belirlemek için kullanılır. Örneğin, bir |
barcode |
Barkod türü ve değeri. |
messages[] |
Uygulamada görüntülenen mesaj dizisi. Bu nesnenin tüm kullanıcıları, ilgili mesajları alacaktır. Bu alanların maksimum sayısı 10'dur. |
validTimeInterval |
Bu nesnenin |
locations[] |
Not: Şu anda bu alanın coğrafi bildirimleri tetiklemesi desteklenmemektedir. |
hasUsers |
Nesnede kullanıcı olup olmadığını gösterir. Bu alan, platform tarafından ayarlanır. |
smartTapRedemptionValue |
Bu nesne için NFC üzerinden Akıllı Dokunma onaylı bir terminale iletilecek değer. Kartın Akıllı Dokunma'yı desteklemesi için |
hasLinkedDevice |
Bu nesnenin şu anda tek bir cihaza bağlı olup olmadığı. Bu alan, kullanıcı nesneyi kaydedip cihazına bağladığında platform tarafından ayarlanır. Belirli iş ortaklarının kullanması için tasarlanmıştır. Ek bilgi için destek ekibiyle iletişime geçin. |
disableExpirationNotification |
Bildirimlerin açıkça engellenip engellenmeyeceğini belirtir. Bu alan doğru değerine ayarlanırsa Bu ayar şu anda yalnızca fırsatlar için ayarlanabilir. |
infoModuleData |
Kullanımdan kaldırıldı. Bunun yerine textModulesData kullanın. |
imageModulesData[] |
Resim modülü verileri. Bu alanlardan en fazla 1 tanesi nesne düzeyinde, 1'i sınıf nesne düzeyinde gösterilir. |
textModulesData[] |
Metin modülü verileri. Sınıfta metin modülü verileri de tanımlanmışsa her ikisi de gösterilir. Bu alanlardan en fazla 10 tanesi nesneden, 10'u ise sınıftan görüntülenebilir. |
linksModuleData |
Bağlantılar modülü verileri. Sınıfta bağlantılar modülü verileri de tanımlanmışsa her ikisi de görüntülenir. |
appLinkData |
Kartın ön kısmında düğme olarak gösterilecek isteğe bağlı uygulama veya web sitesi bağlantısı. İlgili sınıf nesnesi için AppLinkData sağlanırsa yalnızca AppLinkData görüntülenir. |
activationStatus |
Nesnenin etkinleştirme durumu. Sınıfta |
rotatingBarcode |
Dönen barkod türü ve değeri. |
deviceContext |
Nesneyle ilişkilendirilen cihaz bağlamı. |
heroImage |
Kartın ön kısmında gösterilen isteğe bağlı banner resmi. Herhangi bir sınıf yoksa sınıfın hero resmi (varsa) gösterilir. Sınıfa ait hero resim de yoksa hiçbir şey görüntülenmez. |
groupingInfo |
Kartların nasıl gruplandırılacağını kontrol eden bilgiler. |
passConstraints |
Nesne için kısıtlamaları geçirin. Sınırlayıcı NFC ve ekran görüntüsü davranışlarını içerir. |
PassengerType
Sıralamalar | |
---|---|
PASSENGER_TYPE_UNSPECIFIED |
|
SINGLE_PASSENGER |
|
singlePassenger |
|
MULTIPLE_PASSENGERS |
|
multiplePassengers |
|
TicketStatus
Sıralamalar | |
---|---|
TICKET_STATUS_UNSPECIFIED |
|
USED |
|
used |
|
REFUNDED |
|
refunded |
|
EXCHANGED |
|
exchanged |
|
ConcessionCategory
Sıralamalar | |
---|---|
CONCESSION_CATEGORY_UNSPECIFIED |
|
ADULT |
|
adult |
|
CHILD |
|
child |
|
SENIOR |
|
senior |
|
TicketRestrictions
JSON gösterimi |
---|
{ "routeRestrictions": { object ( |
Alanlar | |
---|---|
routeRestrictions |
Kullanılabilecek rotalarla ilgili kısıtlamalar. Örneğin, bu, "Yalnızca arazisinde ayrılmış trenler" dizesi olabilir. |
routeRestrictionsDetails |
Yukarıdaki |
timeRestrictions |
Bu biletin kullanılabileceği zamanlarla ilgili kısıtlamalar. |
otherRestrictions |
"Rota" veya "süre" kategorilerine girmeyen ekstra kısıtlamalar. |
PurchaseDetails
JSON gösterimi |
---|
{
"purchaseReceiptNumber": string,
"purchaseDateTime": string,
"accountId": string,
"confirmationCode": string,
"ticketCost": {
object ( |
Alanlar | |
---|---|
purchaseReceiptNumber |
Bilet satın alımını, bileti satan gövde aracılığıyla izlemek için kullanılan makbuz numarası/tanımlayıcı. |
purchaseDateTime |
Biletin satın alındığı tarih/saat. Bu değer, ofseti olan veya olmayan, ISO 8601 genişletilmiş biçiminde bir tarih/saattir. Zaman, nanosaniye hassasiyete kadar belirtilebilir. Zaman farkı, saniye hassasiyetiyle belirtilebilir (ofsetteki saniye değeri, ISO 8601'in bir parçası olmasa bile). Örneğin:
Ofset bilgileri olmadan bazı zengin özellikler kullanılamayabilir. |
accountId |
Bileti satın almak için kullanılan hesabın kimliği. |
confirmationCode |
Satın alma işleminin onay kodu. Bu, birden fazla farklı bilet için aynı olabilir ve biletleri gruplandırmak için kullanılır. |
ticketCost |
Biletin maliyeti. |
TicketCost
JSON gösterimi |
---|
{ "faceValue": { object ( |
Alanlar | |
---|---|
faceValue |
Biletin orijinal fiyatı. |
purchasePrice |
Biletin vergi ve/veya indirimlerden sonraki gerçek satış fiyatı. |
discountMessage |
Uygulanan herhangi bir indirim türünü açıklayan bir ileti. |
TicketLeg
JSON gösterimi |
---|
{ "originStationCode": string, "originName": { object ( |
Alanlar | |
---|---|
originStationCode |
Kalkış istasyonunun kodu. |
originName |
Kalkış istasyonunun adı. |
destinationStationCode |
Hedef istasyon kodu. |
destinationName |
Hedef adı. |
departureDateTime |
Kalkış tarihi/saati. Taşıma nesnesinde geçerlilik süresi ayarlanmamışsa bu gereklidir. Bu değer, ofseti olan veya olmayan, ISO 8601 genişletilmiş biçiminde bir tarih/saattir. Zaman, nanosaniye hassasiyete kadar belirtilebilir. Zaman farkı, saniye hassasiyetiyle belirtilebilir (ofsetteki saniye değeri, ISO 8601'in bir parçası olmasa bile). Örneğin:
Ofset içermeyen tarih/saat kısmı, "yerel tarih/saat" olarak kabul edilir. Bu, kalkış istasyonundaki yerel tarih/saat olmalıdır. Örneğin, kalkış istasyonunda 5 Haziran 2018'in 20. saatinde kalkış yapılırsa yerel tarih/saat kısmı Ofset bilgileri olmadan bazı zengin özellikler kullanılamayabilir. |
arrivalDateTime |
Varış tarihi/saatidir. Bu değer, ofseti olan veya olmayan, ISO 8601 genişletilmiş biçiminde bir tarih/saattir. Zaman, nanosaniye hassasiyete kadar belirtilebilir. Zaman farkı, saniye hassasiyetiyle belirtilebilir (ofsetteki saniye değeri, ISO 8601'in bir parçası olmasa bile). Örneğin:
Ofset içermeyen tarih/saat kısmı, "yerel tarih/saat" olarak kabul edilir. Hedef istasyondaki yerel tarih/saat olmalıdır. Örneğin, etkinlik 5 Haziran 2018'in 20. saatinde hedef istasyonda gerçekleşirse yerel tarih/saat kısmı Ofset bilgileri olmadan bazı zengin özellikler kullanılamayabilir. |
fareName |
Seyahatin bu ayağı için ücretin kısa açıklaması/adı. Ör. "Her Zaman Tek Kullanımlık". |
carriage |
Yolcunun binmesi gereken tren veya geminin adı/numarası. |
platform |
Yolcunun vagona binebileceği platform veya kapı. |
zone |
Platformdaki biniş alanı. |
ticketSeat |
Yolcular için ayrılmış koltuk. Birden fazla lisans belirtilecekse bunun yerine |
ticketSeats[] |
Yolcular için ayrılmış koltuk. Yalnızca bir lisans belirtilecekse bunun yerine |
transitOperatorName |
Gezinin bu ayağını işleten toplu taşıma operatörünün adı. |
transitTerminusName |
Terminus istasyonu veya tren/otobüs/vb. varış noktaları |
TicketSeat
JSON gösterimi |
---|
{ "fareClass": enum ( |
Alanlar | |
---|---|
fareClass |
Biletli koltuğun ücret sınıfıdır. |
customFareClass |
|
coach |
Biletli koltuğun bulunduğu tren vagonu veya otobüsün tanımlayıcısı. Ör. "10" |
seat |
Biletli koltuğun bulunduğu yerin tanımlayıcısı. Ör. "42". Belirli bir tanımlayıcı yoksa bunun yerine |
seatAssignment |
Yolcu koltuğunun ataması. Ör. "belirli bir koltuk yok". |
FareClass
Sıralamalar | |
---|---|
FARE_CLASS_UNSPECIFIED |
|
ECONOMY |
|
economy |
|
FIRST |
|
first |
|
BUSINESS |
|
business |
|
TripType
Sıralamalar | |
---|---|
TRIP_TYPE_UNSPECIFIED |
|
ROUND_TRIP |
|
roundTrip |
|
ONE_WAY |
|
oneWay |
|
ActivationStatus
Nesnenin etkinleştirme durumu. Bu alanda, değerli olması durumunda etkinleştirme durumu yer alır.
JSON gösterimi |
---|
{
"state": enum ( |
Alanlar | |
---|---|
state |
|
Eyalet
Sıralamalar | |
---|---|
UNKNOWN_STATE |
|
NOT_ACTIVATED |
Etkinleştirilmedi, varsayılan durum budur |
not_activated |
|
ACTIVATED |
Etkin |
activated |
|
DeviceContext
Nesneyle ilişkilendirilen cihaz bağlamı.
JSON gösterimi |
---|
{ "deviceToken": string } |
Alanlar | |
---|---|
deviceToken |
Ayarlanırsa teklifi kullanma bilgileri yalnızca nesnenin etkinleştirilmesinin ardından belirtilen cihaza döndürülür. Bu, bir kullanıcının cihazını izlemek için sabit bir tanımlayıcı olarak kullanılmamalıdır. Aynı cihazın farklı geçiş kartlarında, hatta aynı cihazda yapılan farklı etkinleştirmelerde bile değişiklik gösterebilir. Bu ayar yapılırken arayanların, etkinleştirilmekte olan nesnede hasLinkedDevice'i de ayarlaması gerekir. |
Yöntemler |
|
---|---|
|
Belirtilen nesne kimliği tarafından başvurulan geçiş nesnesine bir ileti ekler. |
|
Verilen nesne kimliğine sahip geçiş nesnesini döndürür. |
|
Verilen kimliğe ve özelliklere sahip bir taşıma nesnesi ekler. |
|
Belirli bir yayıncı kimliği için tüm geçiş nesnelerinin listesini döndürür. |
|
Belirtilen nesne kimliğinin başvurduğu geçiş nesnesini günceller. |
|
Belirtilen nesne kimliğinin başvurduğu geçiş nesnesini günceller. |