Bu dokümanda, bir Toplu Taşıma Operatörü (PTO) ve bundan sonra kartı veren kuruluş olarak anılacak olan sistem entegratörünün Google Cüzdan'da Motics uygulaması sağlamak için uygulaması gereken adımlar ele alınmaktadır.
1. Ön Koşulları Tamamlayın
- Google ile bir gizlilik sözleşmesi (NDA) imzalamalıdır. Tıklanarak kabul edilen bu çevrimiçi form, Google'ın iş geliştirme (BD) ekibi tarafından paylaşılmaktadır.
- QR kodları için standart Google Cüzdan API'si ile entegrasyon yapın:
- Kartı veren kuruluş, kartların temel hazırlığını yapmak ve bunları kullanıcının Google Cüzdan uygulamasına eklemek için Google Cüzdan API'sini kullanır. Toplu Taşıma QR Kodları belgelerini inceleyin ve API ile entegrasyon için gerekli ön koşulları tamamlayın.
- Bir ownerId (kuruluşId) ve Motics için gerekli PKI bilgilerini almak için VDV e-Bilet Hizmeti'ne kaydolun.
2. Teknik Uygulama
2. Adım, paralel olarak geliştirilmesi gereken ana teknik uygulama ayrıntılarını içerir.
Google Cüzdan API'si Uygulamanızı Yeni Sürüme Geçirin
Teknik Ayrıntılar sayfasında, kartı veren kuruluşun Motics entegrasyonu için kullanması ve güncellemesi gereken yöntemler ve parametreler özetlenir. Spesifik olarak, kartı veren kuruluşun aşağıdaki Google Cüzdan API yöntemlerini Motics ile ilgili ek parametrelerle çağırması gerekir:
Etkinleştirme uç noktasını uygulama
Google sunucusu, yayıncı tarafından barındırılan etkinleştirme uç noktasını çağırır. Bu işlem, sertifikayı veren sunucuda statik yararlanma hakkı verilerinin (sigSTB) oluşturulmasını tetikler. Ayrıntılar için etkinleştirme uç noktası bölümünü inceleyin.
Taşı ve Bağlantıyı Kaldır Akışını Uygulama
İyi bir kullanıcı deneyimi sağlamak için kullanıcıların, Motics biletlerini kartı veren kuruluş tarafından tanımlanan belirli sınırlar dahilinde bir cihazdan diğerine taşıyabilmeleri gerekir. Bunun için, kartı veren kuruluşun Taşıma ve Bağlantıyı Kaldırma Akışı'nı uygulaması gerekir.
Bilet kaydedildiğinde onay e-postası gönder
Google, kullanıcılar Google Cüzdan'a bir Motics bileti kaydettiğinde, kartı veren kuruluşun kullanıcılara onay e-postası göndermesini zorunlu tutar. Onay e-postası (en azından) şunları içermelidir:
- Kullanıcıların biletlerini (aboneliklerini) yönetmeleri için faydalı bağlantılar.
- Kartı veren kuruluşun müşteri desteğiyle iletişime geçme talimatları.
3. HAZIRLIK'ta uçtan uca entegrasyon testi yap
Geliştirmede kullanılmak üzere transitClass Google Cüzdan testi oluşturun. Entegrasyon çalışması tamamlandıktan sonra bu geliştirme transitClass kullanılarak çözüm tamamen doğrulanıp test edilmelidir. transitObject:Insert bölümünde cert_environment değerini STAGING olarak ayarlayın. Tüm kullanım alanları tam olarak test edilmeli
ve tüm test durumlarının başarılı bir sonucu olmalıdır.
4. PRODUCTION ürününde uçtan uca test yap
Çözüm, STAGING ortamı kullanılarak başarıyla test edildikten sonra yeni bir transitClass üretim sürümü oluşturun. Bu kez transitObject yerleştirirken cert_environment özelliğini
PRODUCTION olarak ayarlayın. Test bölümündeki tüm test durumlarını ve talimatları uygulayın ve tamamlayın.
5. Kullanıma sunma sürecini takip etme ve onay alma
Herkese açık bir pilot uygulamayı başlatmadan veya başlatmadan önce, Google tarafından tam lansman onayı verilmiş olmalıdır. Onay, çeşitli test aşamalarının sonuçlarına ve Google tarafından incelenip onaylanması gereken aşağıdakiler gibi (ancak bunlarla sınırlı olmamak üzere) diğer faktörlere bağlıdır:
- Genel lansman kapsamı ve planı
- Pilot uygulama olması durumunda lansman planı tam lansmana geçmek için net çıkış kriterleri ve zaman çizelgeleri içermelidir.
- Planlanan Pazarlama Etkinlikleri
- İletişimleri Başlat
- Lansman tarihi
- Lansman günü zaman çizelgeleri, üst birime iletme süreci ve iletişim bilgileri
- Son kullanıcı destek süreçleri