- 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 | |
---|---|
class |
Üst sınıfın devralınan alanlarının bir kopyası. Bu alanlar bir GET sırasında alınır. |
ticket |
Biletin numarası. Bu, toplu taşıma operatörünün sistemindeki biletin benzersiz tanımlayıcısıdır. |
passenger |
Yolcu sayısı. |
passenger |
Biletin atandığı yolcuların adları. Yukarıdaki |
trip |
Kullanıcı aynı seyahat için birden fazla bilet kaydettiyse bu kimlik, biletleri gruplandırmak için kullanılır. |
ticket |
Biletin durumu. Görüntüyü etkileyen durumlar için bunun yerine |
custom |
|
concession |
Biletin ayrıcalık kategorisi. |
custom |
|
ticket |
Bu biletin kullanımıyla ilgili ne tür kısıtlamalar olduğu hakkında bilgi. Örneğin, haftanın hangi günleri kullanılması gerektiğini veya hangi rotaların kullanılmasına izin verildiğini belirleyebilirsiniz. |
purchase |
Bu biletin satın alma ayrıntıları. |
ticket |
Tek bilet ayağında kalkış ve varış bilgilerinin yanı sıra biniş ve oturma yeri bilgileri yer alır. Birden fazla ayak belirtilecekse bunun yerine |
ticket |
Her bilette bir veya daha fazla ayak olabilir. Her ayakta kalkış ve varış bilgilerinin yanı sıra biniş ve oturma yeri bilgileri yer alır. Yalnızca bir ayak belirtilecekse bunun yerine |
hex |
Kartın arka plan rengi. Ayarlanmadan önce hero resmin baskın rengi kullanılır ve hero resim ayarlanmadıysa logonun baskın rengi kullanılır. Biçim #rrggbb şeklindedir. Burada rrggbb, |
trip |
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ıdır. 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çermelidir. |
class |
Zorunlu. Bu nesneyle ilişkili sınıf. Sınıfın bu nesne ile aynı türde olması, zaten mevcut olması ve onaylanması gerekir. 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, bir |
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 en fazla 10 tane olabilir. |
valid |
Bu nesnenin |
locations[] |
Not: Şu anda bu alan, coğrafi bildirimleri tetiklemek için desteklenmemektedir. |
has |
Nesnenin kullanıcı olup olmadığını belirtir. Bu alan platform tarafından belirlenir. |
smart |
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 |
has |
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 kullanımına yöneliktir. Daha fazla bilgi için destek ekibiyle iletişime geçin. |
disable |
Bildirimlerin açıkça engellenip engellenmeyeceğini belirtir. Bu alan true (doğru) değerine ayarlanırsa Şu anda bu ayar yalnızca fırsatlar için ayarlanabilir. |
info |
Kullanımdan kaldırıldı. Bunun yerine textModulesData parametresini kullanın. |
image |
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. |
text |
Metin modülü verileri. Metin modülü verileri de sınıfta tanımlanmışsa her ikisi de gösterilir. Bu alanların gösterilen maksimum sayısı, nesneden 10 ve sınıftan 10'dur. |
links |
Bağlantılar modülü verileri. Sınıfta bağlantılar modülü verileri de tanımlanmışsa her ikisi de gösterilir. |
app |
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ğlanmışsa yalnızca AppLinkData nesnesi gösterilir. |
activation |
Nesnenin etkinleşme durumu. Sınıfta |
rotating |
Dönen barkod türü ve değeri. |
device |
Nesneyle ilişkilendirilen cihaz bağlamı. |
hero |
Kartın ön tarafında gösterilen isteğe bağlı banner resmi. Yoksa, varsa sınıfın hero resmi gösterilir. Sınıfın hero resmi de yoksa hiçbir şey gösterilmez. |
grouping |
Kartların nasıl gruplandırılacağını kontrol eden bilgiler. |
pass |
Nesne için kısıtlamaları iletin. NFC ve ekran görüntüsü alma davranışlarını sınırlandırır. |
save |
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. |
linked |
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). LinkedObjectId öğelerindeki nesnelerin eklenmiş olduğundan emin olun. Ekli değilse çağrılar başarısız olur. Bağlı nesnelerin bağlantısı kaldırılamaz. Başka bir verene ait nesneleri 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 burada Google tarafından verilir, ikincisi ise sizin tarafınızdan seçilir. |
notify |
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 ilgili alan bir izin verilenler listesinde yer alıyorsa 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. |
value |
İ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 | |
---|---|
route |
Kullanılabilecek rotalarla ilgili kısıtlamalar. Örneğin, bu "Yalnızca rezerve edilmiş CrossCountry trenleri" dizesi olabilir. |
route |
Yukarıdaki |
time |
Bu biletin kullanılabileceği zamanlarla ilgili kısıtlamalar. |
other |
"Rota" veya "zaman" kategorilerine girmeyen ek kısıtlamalar. |
PurchaseDetails
JSON gösterimi |
---|
{
"purchaseReceiptNumber": string,
"purchaseDateTime": string,
"accountId": string,
"confirmationCode": string,
"ticketCost": {
object ( |
Alanlar | |
---|---|
purchase |
Bileti satan kuruluş aracılığıyla yapılan bilet satın alımını takip etmek için kullanılan makbuz numarası/tanımlayıcı. |
purchase |
Biletin satın alma tarihi/saati. Bu, ISO 8601 genişletilmiş biçiminde bir tarih/saattir (ofsetli veya ofsetsiz). Nanosaniye hassasiyete kadar zaman belirtilebilir. Kaydırmalar saniye hassasiyetiyle belirtilebilir (ayırma saniyesi ISO 8601'in parçası olmasa bile). Örneğin:
Ofset bilgileri olmadan bazı zengin özellikler kullanılamayabilir. |
account |
Bileti satın almak için kullanılan hesabın kimliği. |
confirmation |
Satın alma işleminin onay kodu. Bu, birden fazla farklı bilet için aynı olabilir ve biletleri birlikte gruplandırmak için kullanılır. |
ticket |
Biletin maliyeti. |
TicketCost
JSON gösterimi |
---|
{ "faceValue": { object ( |
Alanlar | |
---|---|
face |
Biletin orijinal fiyatıdır. |
purchase |
Vergi ve/veya indirimlerden sonra biletin gerçek satın alma fiyatı. |
discount |
Uygulanan indirim türlerini açıklayan bir mesaj. |
TicketLeg
JSON gösterimi |
---|
{ "originStationCode": string, "originName": { object ( |
Alanlar | |
---|---|
origin |
Başlangıç istasyonu kodu. |
origin |
Kalkış istasyonunun adı. |
destination |
Varış istasyonunun kodu. |
destination |
Hedef adı. |
departure |
Kalkış tarihi/saati. Transit nesnesinde geçerlilik zaman aralığı ayarlanmamışsa bu gereklidir. Bu, ofseti olan veya olmayan, ISO 8601 genişletilmiş tarih/saat biçimindedir. Zaman, nanosaniye hassasiyetine kadar belirtilebilir. Ofsetler, saniye hassasiyetinde belirtilebilir (ofset saniyeleri ISO 8601'in bir parçası olmasa da). Örneğin:
Ofset içermeyen tarih/saat bölümü, "yerel tarih/saat" olarak kabul edilir. Bu, kalkış istasyonundaki 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. |
arrival |
Varış tarihi/saati. Bu, ISO 8601 genişletilmiş biçiminde bir tarih/saattir (ofsetli veya ofsetsiz). Nanosaniye hassasiyete kadar zaman 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 istasyondaki yerel tarih/saat değeri olmalıdır. Örneğin, etkinlik hedef istasyonda 5 Haziran 2018'in 20 saatinde gerçekleşiyorsa yerel tarih/saat bölümü Ofset bilgileri olmadan bazı zengin özellikler kullanılamayabilir. |
fare |
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 |
Yolcunun vagona binebileceği platform veya kapı. |
zone |
Platformdaki biniş bölgesi. |
ticket |
Yolcular için ayrılmış koltuk. Birden fazla koltuk belirtilmesi gerekiyorsa bunun yerine |
ticket |
Yolcular için ayrılmış koltuk. Yalnızca bir lisans belirtilecekse bunun yerine |
transit |
Seyahatin bu ayağını yürüten toplu taşıma operatörünün adı. |
transit |
Tren/otobüsün vb. terminali veya varış noktası |
TicketSeat
JSON gösterimi |
---|
{ "fareClass": enum ( |
Alanlar | |
---|---|
fare |
Biletli koltuğun ücret sınıfı. |
custom |
|
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ı. Ör. "42". Belirli bir tanımlayıcı yoksa bunun yerine |
seat |
Yolcunun koltuk ataması. Ör. "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. 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, bu varsayılan durumdur. |
not_activated |
|
ACTIVATED |
Etkinleştirildi |
activated |
|
DeviceContext
Nesneyle ilişkilendirilmiş cihaz bağlamı.
JSON gösterimi |
---|
{ "deviceToken": string } |
Alanlar | |
---|---|
device |
Ayarlanırsa kod kullanma bilgileri yalnızca nesnenin etkinleştirilmesinden sonra belirli cihaza döndürülür. Bu kimlik, bir kullanıcının cihazını izlemek için kararlı bir tanımlayıcı olarak kullanılmamalıdır. Aynı cihazdaki farklı kartlarda veya aynı cihazın farklı etkinleştirmelerinde bile 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ğinin referansta bulunduğu geçiş nesnesini günceller. |
|
Belirtilen nesne kimliğinin referansta bulunduğu geçiş nesnesini günceller. |