- 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 sırasında alınır. |
ticketNumber |
Biletin numarası. Bu, toplu taşıma operatörünün sistemindeki biletin benzersiz tanımlayıcısıdır. |
passengerType |
Yolcu sayısı. |
passengerNames |
Biletin atandığı yolcuların adları. Yukarıdaki |
tripId |
Kullanıcı aynı seyahat için birden fazla bilet kaydettiyse bu kimlik, biletleri gruplandırmak için kullanılır. |
ticketStatus |
Biletin durumu. Görüntülemeyi etkileyen durumlar için bunun yerine |
customTicketStatus |
|
concessionCategory |
Biletin ayrıcalık kategorisi. |
customConcessionCategory |
|
ticketRestrictions |
Bu biletin kullanımında ne tür kısıtlamalar olduğu hakkında bilgi. Örneğin, haftanın hangi günlerinde kullanılması gerektiği veya hangi rotaların kullanılmasına izin verildiği. |
purchaseDetails |
Bu biletin satın alma ayrıntıları. |
ticketLeg |
Tek bir bilet seferi, biniş ve koltuk bilgilerinin yanı sıra kalkış ve varış bilgilerini içerir. Birden fazla aşama belirtilecekse bunun yerine |
ticketLegs[] |
Her bilet bir veya daha fazla uçuş segmenti içerebilir. Her uçuş, biniş ve koltuk bilgileriyle birlikte kalkış ve varış bilgilerini içerir. Yalnızca bir ayak belirtilecekse bunun yerine |
hexBackgroundColor |
Kartın arka plan rengi. Ayarlanmamışsa hero resminin baskın rengi, ayarlanmamışsa logonun baskın rengi kullanılır. Biçim #rrggbb şeklindedir. Burada rrggbb, |
tripType |
Zorunlu. Bu toplu taşıma nesnesinin temsil ettiği seyahat türü. Kart başlığını ve/veya kaynak ile hedef arasında kullanılacak simgeyi belirlemek için kullanılır. |
id |
Zorunlu. Bir nesnenin benzersiz tanımlayıcısı. Bu kimlik, bir verenin tüm nesneleri arasında benzersiz olmalıdır. Bu değer issuer ID biçiminde olmalıdır.identifier. Bunlardan ilki Google tarafından verilir, ikincisi ise sizin tarafınızdan seçilir. Benzersiz tanımlayıcı yalnızca alfanümerik karakterler, ".", "_" veya "-" işaretlerini içermelidir. |
classId |
Zorunlu. Bu nesneyle ilişkili sınıf. Sınıf, bu nesneyle aynı türde olmalı, zaten mevcut olmalı ve onaylanmalıdır. Sınıf kimlikleri issuer ID biçimini izlemelidir.identifier. Bunlardan ilki Google tarafından verilir, ikincisi ise sizin tarafınızdan seçilir. |
version |
Kullanımdan kaldırıldı |
state |
Zorunlu. Nesnenin durumu. Bu alan, bir nesnenin uygulamada nasıl gösterileceğini belirlemek için kullanılır. Örneğin, |
barcode |
Barkod türü ve değeri. |
messages[] |
Uygulamada gösterilen bir mesaj dizisi. Bu nesnenin tüm kullanıcıları, ilişkili mesajları alır. Bu alanların maksimum sayısı 10'dur. |
validTimeInterval |
Bu nesnenin |
locations[] |
Not: Bu alan şu anda coğrafi bildirimleri tetiklemek için desteklenmemektedir. |
hasUsers |
Nesnenin kullanıcısı olup olmadığını belirtir. Bu alan platform tarafından belirlenir. |
smartTapRedemptionValue |
Bu nesne için NFC üzerinden Smart Tap sertifikalı bir terminale iletilecek değer. Kartın Akıllı Dokunma'yı desteklemesi için sınıf düzeyindeki |
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ı tarafından kullanılmak üzere tasarlanmıştır. Daha fazla bilgi için destek ekibiyle iletişime geçin. |
disableExpirationNotification |
Bildirimlerin açıkça engellenip engellenmeyeceğini belirtir. Bu alan true (doğru) değerine ayarlanırsa Bu özellik şu anda yalnızca teklifler için ayarlanabilir. |
infoModuleData |
Kullanımdan kaldırıldı. Bunun yerine textModulesData parametresini kullanın. |
imageModulesData[] |
Resim modülü verileri. Bu alanların gösterilen maksimum sayısı, nesne düzeyinde 1 ve sınıf nesnesi düzeyinde 1'dir. |
textModulesData[] |
Metin modülü verileri. Sınıfta metin modülü verileri de tanımlanmışsa her ikisi de gösterilir. Bu alanların gösterilen maksimum sayısı, nesneden 10 ve sınıftan 10'dur. |
linksModuleData |
Bağlantılar modülü verileri. Sınıfta bağlantılar modülü verileri de tanımlanmışsa her ikisi de gösterilir. |
appLinkData |
Kartın ön tarafında düğme olarak gösterilecek isteğe bağlı uygulama veya web sitesi bağlantısı. İlgili sınıf için AppLinkData sağlanırsa yalnızca AppLinkData nesnesi gösterilir. |
activationStatus |
Nesnenin etkinleşme durumu. Sınıfta |
rotatingBarcode |
Dönen barkod türü ve değeri. |
deviceContext |
Nesneyle ilişkili cihaz bağlamı. |
heroImage |
Kartın ön tarafında gösterilen isteğe bağlı banner resmi. Hiçbiri yoksa sınıfın hero resmi (varsa) gösterilir. Sınıfın hero resmi de yoksa hiçbir şey gösterilmez. |
groupingInfo |
Kartların nasıl gruplandırılacağını kontrol eden bilgiler. |
passConstraints |
Nesne için kısıtlamaları iletin. NFC ve ekran görüntüsü davranışlarını sınırlama da buna dahildir. |
saveRestrictions |
Kullanıcı geçişi kaydetmeye çalışmadan önce doğrulanması gereken nesne kısıtlamaları. Bu kısıtlamaların yalnızca kayıt sırasında uygulanacağını unutmayın. Kullanıcı geçişi kaydettikten sonra kısıtlamalar değişirse yeni kısıtlamalar, önceden kaydedilmiş geçişlere uygulanmaz. |
linkedObjectIds[] |
linkedObjectIds, bu toplu taşıma nesnesine otomatik olarak eklenmesi gereken etkinlik bileti, bağlılık, teklif, genel, hediye kartı, toplu taşıma ve biniş kartı gibi diğer nesnelerin bir listesidir. Bir kullanıcı bu toplu taşıma kartını kaydettiyse bu linkedObjectIds, kullanıcının cüzdanına otomatik olarak gönderilir (bu tür bağlı kartları alma ayarını devre dışı bırakmadığı sürece). linkedObjectIds'de bulunan nesnelerin zaten eklendiğinden emin olun. Aksi takdirde çağrılar başarısız olur. Bağlı nesnelerin bağlantısı kaldırılamaz. Başka bir ihraççının nesnelerini bağlayamazsınız. Tek bir nesneye bağlanabilecek nesne sayısı sınırlıdır. Sınıra ulaşıldığında görüşmedeki yeni bağlı nesneler sessizce yoksayılır. Nesne kimlikleri issuer ID biçimini izlemelidir.identifier. Bunlardan ilki Google tarafından, ikincisi ise sizin tarafınızdan seçilir. |
notifyPreference |
Bu nesneyle ilgili alan güncellemelerinin bildirim tetiklemesi gerekip gerekmediği. NOTIFY olarak ayarlandığında, kullanıcılara alan güncelleme bildirimi göndermeye çalışırız. Bu bildirimler yalnızca alan izin verilenler listesindeyse kullanıcılara gönderilir. DO_NOT_NOTIFY veya NOTIFICATION_SETTINGS_UNSPECIFIED olarak ayarlanırsa bildirim tetiklenmez. Bu ayar geçicidir ve her PATCH veya UPDATE isteğiyle birlikte ayarlanması gerekir. Aksi takdirde bildirim tetiklenmez. |
valueAddedModuleData[] |
İsteğe bağlı katma değer modülü verileri. Nesnede en fazla on tane olabilir. |
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 rezerve edilmiş CrossCountry trenleri" dizesi olabilir. |
routeRestrictionsDetails |
Yukarıdaki |
timeRestrictions |
Bu biletin kullanılabileceği saatlerle ilgili kısıtlamalar. |
otherRestrictions |
"Rota" veya "zaman" kategorilerine girmeyen ek kısıtlamalar. |
PurchaseDetails
JSON gösterimi |
---|
{
"purchaseReceiptNumber": string,
"purchaseDateTime": string,
"accountId": string,
"confirmationCode": string,
"ticketCost": {
object ( |
Alanlar | |
---|---|
purchaseReceiptNumber |
Bileti satan kuruluş üzerinden bilet satın alma işlemini izlemek için makbuz numarası/tanımlayıcı. |
purchaseDateTime |
Biletin satın alma tarihi/saati. Bu, ISO 8601 genişletilmiş biçiminde bir tarih/saattir (ofset içerebilir veya içermeyebilir). Zaman, nanosaniye hassasiyetine kadar belirtilebilir. Ofsetler, saniye hassasiyetinde belirtilebilir (ofset saniyeleri ISO 8601'in bir parçası olmasa da). Ö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 değer, 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 nominal değeri. |
purchasePrice |
Vergi ve/veya indirimlerden sonra biletin gerçek satın alma fiyatı. |
discountMessage |
Uygulanan indirim türlerini açıklayan bir mesaj. |
TicketLeg
JSON gösterimi |
---|
{ "originStationCode": string, "originName": { object ( |
Alanlar | |
---|---|
originStationCode |
Başlangıç istasyonu kodu. Bu, |
originName |
Kalkış istasyonunun adı. Bu, |
destinationStationCode |
Hedef istasyon kodu. |
destinationName |
Hedef adı. |
departureDateTime |
Kalkış tarihi/saati. Transit nesnesinde geçerlilik zaman aralığı ayarlanmamışsa bu gereklidir. Bu, ISO 8601 genişletilmiş biçiminde bir tarih/saattir (ofset içerebilir veya içermeyebilir). Zaman, nanosaniye hassasiyetine kadar belirtilebilir. Ofsetler, saniye hassasiyetinde belirtilebilir (ofset saniyeleri ISO 8601'in bir parçası olmasa da). Örneğin:
Tarih/saatin ofset içermeyen kısmı "yerel tarih/saat" olarak kabul edilir. Bu, kaynak istasyondaki yerel tarih/saat olmalıdır. Örneğin, kalkış 5 Haziran 2018'in 20. saatinde, kalkış istasyonunda gerçekleşiyorsa yerel tarih/saat bölümü Ofset bilgileri olmadan bazı zengin özellikler kullanılamayabilir. |
arrivalDateTime |
Varış tarihi/saati. Bu, ISO 8601 genişletilmiş biçiminde bir tarih/saattir (ofset içerebilir veya içermeyebilir). Zaman, nanosaniye hassasiyetine kadar belirtilebilir. Ofsetler, saniye hassasiyetinde belirtilebilir (ofset saniyeleri ISO 8601'in bir parçası olmasa da). Örneğin:
Tarih/saatin ofset içermeyen kısmı "yerel tarih/saat" olarak kabul edilir. Bu, hedef istasyonun yerel tarihi/saati olmalıdır. Örneğin, etkinlik 5 Haziran 2018'in 20. saatinde hedef istasyonda gerçekleşirse yerel tarih/saat bölümü Ofset bilgileri olmadan bazı zengin özellikler kullanılamayabilir. |
fareName |
Bu seyahat ayağının ücretinin kısa açıklaması/adı. Ör. "Herhangi bir zamanda tek kullanımlık". |
carriage |
Yolcunun binmesi gereken tren veya gemi adı/numarası. |
platform |
Yolcuların vagona binebileceği platform veya kapı. |
zone |
Platformdaki biniş bölgesi. |
ticketSeat |
Yolcular için ayrılmış koltuk. Birden fazla koltuk belirtilecekse bunun yerine |
ticketSeats[] |
Yolcular için ayrılmış koltuk. Yalnızca bir koltuk belirtilecekse bunun yerine |
transitOperatorName |
Seyahatin bu bölümünü işleten toplu taşıma operatörünün adı. |
transitTerminusName |
Trenin/otobüsün/vb. son durağı veya varış noktası |
TicketSeat
JSON gösterimi |
---|
{ "fareClass": enum ( |
Alanlar | |
---|---|
fareClass |
Biletli koltuğun ücret sınıfı. |
customFareClass |
|
coach |
Biletli koltuğun bulunduğu tren vagonunun veya otobüsün tanımlayıcısıdır. Ör. "10" |
seat |
Biletli koltuğun bulunduğu yerin tanımlayıcısıdır. Ör. "42". Belirli bir tanımlayıcı yoksa bunun yerine |
seatAssignment |
Yolcunun koltuk ataması. Ör. "no specific seat". |
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. Değerli öğe etkinleştirmeyi destekliyorsa bu alan etkinleştirme durumunu içerir.
JSON gösterimi |
---|
{
"state": enum ( |
Alanlar | |
---|---|
state |
|
Eyalet
Sıralamalar | |
---|---|
UNKNOWN_STATE |
|
NOT_ACTIVATED |
Etkin değil (varsayılan durum) |
not_activated |
|
ACTIVATED |
Etkinleştirildi |
activated |
|
DeviceContext
Nesneyle ilişkili cihaz bağlamı.
JSON gösterimi |
---|
{ "deviceToken": string } |
Alanlar | |
---|---|
deviceToken |
Ayarlanırsa kod kullanma bilgileri yalnızca nesnenin etkinleştirilmesinden sonra belirli cihaza döndürülür. Bu, kullanıcının cihazını izlemek için sabit bir tanımlayıcı olarak kullanılmamalıdır. Bu durum, aynı cihazdaki farklı kartlar veya aynı cihazdaki farklı etkinleştirmeler arasında değişebilir. Bu ayarı yaparken, arayanların etkinleştirilen nesnede hasLinkedDevice'yi de ayarlamaları gerekir. |
Yöntemler |
|
---|---|
|
Belirtilen nesne kimliği tarafından referans verilen toplu taşıma nesnesine bir mesaj ekler. |
|
Belirtilen nesne kimliğine sahip toplu taşıma nesnesini döndürür. |
|
Belirtilen kimliğe ve özelliklere sahip bir toplu taşıma nesnesi ekler. |
|
Belirli bir veren kimliği için tüm geçiş nesnelerinin listesini döndürür. |
|
Belirtilen nesne kimliği tarafından referans verilen toplu taşıma nesnesini günceller. |
|
Belirtilen nesne kimliği tarafından referans verilen toplu taşıma nesnesini günceller. |