როგორ განისაზღვროს მგზავრის აპლიკაციისა და რობოტაქსის ინტეგრაციის ფარგლები

მგზავრის აპლიკაციისა და რობოტაქსის ინტეგრაცია დაიწყეთ მოვლენების რუკით: ვინ ქმნის შეკვეთას, რომელი სისტემა აბრუნებს ფასის ან ხელმისაწვდომობის პასუხს, როგორ იცვლება მგზავრობის სტატუსი და ვინ აგვარებს შეცდომას. ეს საზღვრები სატესტო გარემოში ჩაწერეთ, სანამ დიზაინსა და ვადაზე შეთანხმდებით. ადრეული წვდომის განხილვა aiTAXI-ის გუნდთან შესაძლებელია.

სარედაქციო შენიშვნა: ტექსტი ხელოვნური ინტელექტის დახმარებით მომზადდა საჯარო API დოკუმენტებისა და aiTAXI-ის საჯარო აღწერის შეჯამებით. ეს არ ადასტურებს მოქმედ მგზავრის აპთან aiTAXI-ის ინტეგრაციას, საქართველოში დამტკიცებულ პროცედურას ან მოქმედ ფლოტს. რეალურ პილოტამდე გადაამოწმეთ ტექნიკური, სამართლებრივი და უსაფრთხოების პირობები შესაბამის სპეციალისტებთან.

რას ნიშნავს ინტეგრაციის ფარგლები?

ფრაზა „აპლიკაციის დაკავშირება“ ძალიან ფართოა. ერთი გუნდი შეიძლება გულისხმობდეს შეკვეთის შექმნას, მეორე კი მანქანის რეალურ დროში მდებარეობას, მხარდაჭერას, გადახდას და ინციდენტის მონაცემს. პილოტისთვის ჯერ განსაზღვრეთ ყველაზე ვიწრო მგზავრობის გზა: ძიება, დადასტურება, მანქანის მინიჭება, მგზავრობის დასრულება და გაუქმება.

Booking.com-ის Taxi Supplier API საჯაროდ აღწერს ფასების მიწოდებას, შეკვეთის მიღებას ან უარყოფას, მძღოლის მოვლენებს, OAuth ავტორიზაციას, sandbox-სა და webhook-ებს. Tanzim-ის გვერდი საუბრობს არსებული აპლიკაციიდან შეკვეთის შექმნაზე, შეცვლასა და გაუქმებაზე, მინიჭების სტატუსსა და ETA-ზე. ეს კომპანიების საკუთარი შეთავაზებებია; ისინი aiTAXI-ის ან თქვენი აპლიკაციის შესაძლებლობას არ ადასტურებს.

მოვლენების რუკა ინტეგრაციის ბირთვია

მოვლენაზე შეთანხმება მხოლოდ სახელის შეთანხმება არ არის. თითოეულ ჩანაწერს უნდა ჰქონდეს უნიკალური იდენტიფიკატორი, დრო, განმეორებითი შეტყობინების წესი და საბოლოო მდგომარეობა. თუ აპლიკაცია მხოლოდ „მიმდინარეობს“ სტატუსს ხედავს, ოპერატორი ვერ გაარჩევს დაგვიანებას, გაუქმებასა და დაკარგულ კავშირს.

სცენარები და ნაბიჯები sandbox-ში

სატესტო გარემოში დაგეგმეთ 3 მოკლე გზა და ყველა გზა განზრახ შეაფერხეთ: დუბლირებული webhook, დაგვიანებული სტატუსი და გაუქმება მანქანის მინიჭების შემდეგ. ეს 3 სცენარი სარედაქციო სამუშაო მეთოდია და არა ბაზრის შედეგი. თითოეულზე 2 კითხვა დასვით: რას ხედავს მგზავრი და რა რჩება ოპერატორის ჩანაწერში?

1. ავტორიზაცია. განსაზღვრეთ რომელი მონაცემის წვდომა სჭირდება აპლიკაციას და როგორ უქმდება იგი.
2. გამეორება. მოითხოვეთ იგივე მოვლენის ორჯერ მიღება და დააფიქსირეთ, შეიქმნა თუ არა მეორე შეკვეთა.
3. დაბრუნება. სცადეთ დაკარგული პასუხის შემდეგ უსაფრთხო ხელით შემოწმება.
4. მხარდაჭერა. განსაზღვრეთ, რომელ გუნდს ეკუთვნის მგზავრის შეტყობინება და რომელს ტექნიკური ინციდენტი.

რომელი ინტეგრაციის მიდგომა ჯდება პილოტში?

რას ვერ გადაწყვეტს ეს ჩარჩო?

API-ის გვერდი არ წყვეტს საქართველოს ტრანსპორტის, მომხმარებლის თანხმობისა და უსაფრთხოების ყველა საკითხს. არ გამოიგონოთ ინტეგრაციის ფასი, ვადა, პარტნიორი ან წარმატების მაჩვენებელი. aiTAXI-ის საჯარო აღწერა ეხება ფლოტის ოპერაციებს, დისპეტჩერიზაციასა და ტელემეტრიას; მგზავრის აპლიკაციასთან კონკრეტული კავშირი ჯერ მოთხოვნების და ტესტის საგანია.

პროექტის სამუშაო დავალებაში ცალკე ჩაწერეთ აპლიკაციის მფლობელი, დისპეტჩერის მფლობელი, მანქანის მონაცემის მფლობელი და მხარდაჭერის მორიგე. შეთანხმდით, რომ ერთი მოთხოვნის შეცდომა არ შექმნის პარალელურ ხელით შეკვეთას. დატესტეთ ვალიდაციის უარი, ავტორიზაციის ამოწურვა და webhook-ის განმეორება. ყველა პასუხს უნდა ახლდეს მიზეზი, დრო და ის გუნდი, რომელიც შემდეგ მოქმედებას ასრულებს.

თუ მოვლენების რუკა ვერ ხსნის, რატომ შეიცვალა სტატუსი, ინტეგრაცია ჯერ მზად არ არის. ასეთ დროს შეაჩერეთ ფარგლების გაფართოება, მოითხოვეთ მწარმოებლის ტექნიკური განმარტება და მხოლოდ დადასტურებული ნაკადი დატოვეთ პილოტში.

მიღების ბარათში ჩაწერეთ, როგორ იქცევა აპლიკაცია მაშინ, როცა პასუხი გვიან მოდის. მგზავრმა უნდა ნახოს გასაგები მდგომარეობა, დისპეტჩერმა კი უნდა შეძლოს იმავე შეკვეთის მოძებნა ერთი იდენტიფიკატორით. შეთანხმდით, რომ შეცვლილი პიკაპის ადგილი, გაუქმებული მანქანა და მგზავრის დახმარების მოთხოვნა სხვადასხვა მოვლენებად ჩაიწერება. ასე ეკრანზე განახლებული ინფორმაცია ოპერაციულ მტკიცებულებად არ აგერევათ.

საბოლოო სამუშაო დავალებაში მიუთითეთ, ვინ მართავს ტექსტს, თარგმანსა და შეტყობინების არხს. ტექნიკური კოდის მუშაობა საკმარისი არ არის, თუ მგზავრი გაუგებარ შეცდომას ხედავს ან დახმარების მოთხოვნა გუნდამდე არ მიდის. პირველ პილოტში დატოვეთ მხოლოდ ის ფუნქციები, რომელთა პასუხისმგებელი, მონაცემის წყარო და უკან დაბრუნების გზა წერილობით გაქვთ აღწერილი.

მიღების ოქმში ცალ-ცალკე შეინახეთ გამოგზავნილი მოვლენა, მიღებული სტატუსი და ადამიანის გადაწყვეტილება. თუ ორი სისტემა ერთსა და იმავე შეკვეთაზე განსხვავებულ ისტორიას აჩვენებს, ოქმში მიუთითეთ მონაცემის წყარო და შეუსაბამობის გამოსწორების პასუხისმგებელი. დაუდასტურებელი შედეგი ჩაწერეთ ღია საკითხად და პილოტის შესაძლებლობად ნუ გამოაცხადებთ.

ხშირად დასმული კითხვები

საჭიროა თუ არა თავიდანვე სრული აპლიკაციის გადაკეთება?

არა. ჯერ შეარჩიეთ ყველაზე ვიწრო შეკვეთის გზა და განსაზღვრეთ აუცილებელი მოვლენები. სრული გადაკეთება მხოლოდ მაშინ განიხილეთ, როცა არსებული აპლიკაცია ვერ იღებს საჭირო სტატუსებს ან ვერ იცავს მომხმარებლის მოლოდინს.

ვინ არის პასუხისმგებელი არასწორ სტატუსზე?

პასუხისმგებელი უნდა განისაზღვროს მოვლენების რუკაში: წყაროს სისტემა ამტკიცებს საკუთარ ჩანაწერს, მიმღები აჩვენებს მიღებულ მდგომარეობას, ხოლო ოპერატიული გუნდი მართავს გამონაკლისის პროცესს.

წყაროები

• Booking.com-ის API: მოვლენების შეტყობინებები
• Tanzim-ის მგზავრის აპლიკაცია
• Booking.com-ის API: ავტორიზაცია
• aiTAXI-ის საჯარო აღწერა
• CallTropic-ის დისპეტჩერიზაციის აღწერა

დაკავშირებული მასალა

ინტეგრაციის მიღების კრიტერიუმები, გეოზონის ცვლილების კონტროლი, სერვისის შეწყვეტის გეგმა, მგზავრის გამოუცხადებლობის პროცესი, დაბლოკილი აყვანის ადგილის მართვა, დისტანციური დახმარების ესკალაცია და კონტაქტი.