फ़ीड डिलीवरी के लिए दिशा-निर्देश

इस गाइड में बताया गया है कि जनरेट होने के बाद, Google को अपना माइक्रोमोबिलिटी फ़ीड कैसे उपलब्ध कराएं. अपना फ़ीड बनाने के तरीके के बारे में जानकारी पाने के लिए, रेफ़रंस टैब में दी गई खास बातें देखें.

फ़ीड से जुड़े दिशा-निर्देश

जनरेट किए गए माइक्रोमोबिलिटी फ़ीड को Google को भेजने के लिए, इस प्रोसेस और दिशा-निर्देशों के बारे में जानें:

  • पक्का करें कि साइकल की उपलब्धता और डाइनैमिक किराये का डेटा अप-टू-डेट हो. यह डेटा, उन देशों/इलाकों के लिए ज़रूरी है जहां यह सुविधा उपलब्ध है. इसके लिए, आपको हर 30 सेकंड में GBFS फ़ीड होस्ट पर, फ़ीड का नया वर्शन अपलोड करना होगा. साथ ही, डेटा को वापस पाने में लगने वाला समय 30 सेकंड से ज़्यादा नहीं होना चाहिए.

  • Google को अपना फ़ीड डिलीवर करने के लिए, आपको एचटीटीपी GET का इस्तेमाल करना होगा.

एचटीटीपी GET के साथ फ़ीड डिलीवरी

Google, कॉन्फ़िगर की गई जगह से फ़ीड को HTTPS GET अनुरोध के साथ फ़ेच करता है. साथ ही, पुष्टि करने के इन तरीकों के साथ काम करता है:

  • एचटीटीपी डाइजेस्ट ऑथेंटिकेशन: इसे लागू करने के बाद, कॉन्फ़िगर किए गए उपयोगकर्ता नाम और पासवर्ड को माइक्रोमोबिलिटी पार्टनर की सहायता टीम को ईमेल करें.
  • कस्टम एचटीटीपी हेडर फ़ील्ड: इसके लिए, Google को किए गए अनुरोध के हिस्से के तौर पर, ज़रूरी हेडर फ़ील्ड और उनकी वैल्यू भेजें.
  • GET पैरामीटर: अगर आपको कुछ और GET पैरामीटर की ज़रूरत है, तो उन्हें होस्ट पते में जोड़ें. इसके बाद, इसे माइक्रोमोबिलिटी पार्टनर सहायता टीम को ईमेल करें.

ट्रांसफ़र के दौरान फ़ाइल के साइज़ को ऑप्टिमाइज़ करने के लिए, Google एचटीटीपी हेडर में gzip कंप्रेस करने की सुविधा देता है. खास तौर पर, Google Accept-Encoding: gzip, deflate को HTTP अनुरोध हेडर में भेजता है और HTTP हेडर Content-Encoding: gzip के साथ रिस्पॉन्स स्वीकार करता है.

होस्ट की जगह और उसके बारे में जानकारी तय करने के बाद, कॉन्फ़िगरेशन की जानकारी माइक्रोमोबिलिटी पार्टनर की सहायता टीम को ईमेल करें.

फ़ीड शार्डिंग

किसी फ़ीड को शार्ड करने का मतलब है कि पूरे फ़ीड को कई ऐसे सबसेट में बांटना जो एक-दूसरे से अलग हों. आपके बैकएंड सिस्टम, फ्लीट के टाइप, और साइज़ के आधार पर, शार्डिंग ज़रूरी हो सकती है.

फ़ीड को कब और कैसे शार्ड करना है, इस बारे में तकनीकी जानकारी के लिए, रेफ़रंस सेक्शन में फ़ीड शार्डिंग देखें.

Google, शार्ड किए गए और शार्ड नहीं किए गए, दोनों तरह के फ़ीड को फ़ेच करने के लिए एक ही तरीके का इस्तेमाल करेगा. इसके बारे में एचटीटीपी GET के साथ फ़ीड डिलीवर करना लेख में बताया गया है.

हर शार्ड के लिए होस्ट की जगह और उससे जुड़ी जानकारी तय करने के बाद, माइक्रोमोबिलिटी पार्टनर की सहायता टीम को हर शार्ड के कॉन्फ़िगरेशन की जानकारी ईमेल करें. साथ ही, उन मेट्रो एरिया की जानकारी भी दें जिन्हें शार्ड कवर करता है.