अपने पहले क्लाइंट ऐप्लिकेशन को कोड करना शुरू करने से पहले, आपको कुछ चीज़ें करनी होंगी, बशर्ते आपने उन्हें पहले से पूरा न किया हो.
कोई Google खाता प्राप्त करें
Google API (एपीआई) कंसोल में प्रोजेक्ट बनाने के लिए, आपके पास Google खाता होना ज़रूरी है. अगर आपके पास पहले से ही एक खाता है, तो आप पूरी तरह से तैयार हैं.
आप जांच करने के लिए, एक अलग Google खाता भी बना सकते हैं.
Google Street View आज़माएं
एपीआई के इस दस्तावेज़ में यह माना जाता है कि आपने Google Street View का इस्तेमाल किया है. साथ ही, आप वेब प्रोग्रामिंग के सिद्धांतों और वेब डेटा फ़ॉर्मैट के बारे में जानते हैं.
अगर आपने Google Street View का इस्तेमाल नहीं किया है, तो कोड शुरू करने से पहले, यूज़र इंटरफ़ेस को आज़माएं.
अपने क्लाइंट के लिए प्रोजेक्ट बनाना
Google Street View के लिए अनुरोध भेजने से पहले, आपको Google को अपने क्लाइंट के बारे में बताना होगा और एपीआई का ऐक्सेस चालू करना होगा. इसके लिए, आपको Google API (एपीआई) कंसोल का इस्तेमाल करके एक प्रोजेक्ट बनाना होगा. यह सेटिंग और एपीआई के ऐक्सेस की जानकारी वाले ग्रुप का एक नाम है. साथ ही, अपना ऐप्लिकेशन रजिस्टर करें.
Google Street View Publish API का इस्तेमाल शुरू करने के लिए, आपको पहले सेट अप टूल इस्तेमाल करना होगा. यह आपको Google API (एपीआई) कंसोल में प्रोजेक्ट बनाने, एपीआई की सुविधा चालू करने, और क्रेडेंशियल बनाने की जानकारी देता है.
अगर आपने पहले से ऐसा नहीं किया है, तो क्रेडेंशियल बनाएं > एपीआई कुंजी पर क्लिक करके, अपना ऐप्लिकेशन बनाएं. इसके बाद, एपीआई कुंजियों वाले सेक्शन में अपनी एपीआई कुंजी देखें.
REST की बुनियादी बातें जानें
एपीआई को शुरू करने के दो तरीके हैं:
- एचटीटीपी अनुरोध भेजना और जवाबों को पार्स करना.
- क्लाइंट लाइब्रेरी का इस्तेमाल करके.
अगर आप क्लाइंट लाइब्रेरी का इस्तेमाल नहीं करने का फ़ैसला लेते हैं, तो आपको REST की बुनियादी बातें समझनी होंगी.
REST, सॉफ़्टवेयर आर्किटेक्चर की स्टाइल है. यह डेटा का अनुरोध करने और उसमें बदलाव करने का एक आसान और एक जैसा तरीका उपलब्ध कराता है.
REST का छोटा नाम "Re ज़रूरी तरीके से जुड़ा राज्य ट्रांसफ़र." Google API के संदर्भ में, यह Google को सेव किए गए डेटा को फिर से पाने के लिए, एचटीटीपी कार्रवाइयों का इस्तेमाल करने के बारे में बताता है.
RESTful सिस्टम में, डेटा को डेटा स्टोर में स्टोर किया जाता है; क्लाइंट एक अनुरोध भेजता है कि सर्वर कोई खास कार्रवाई (जैसे कि किसी संसाधन को बनाना, वापस पाना, अपडेट करना या मिटाना) करता है और सर्वर कार्रवाई करता है और अक्सर बताए गए संसाधन को दिखाता है.
Google's RESTful API में, क्लाइंट POST, GET, PUT या DELETE जैसे एचटीटीपी कार्रवाई का इस्तेमाल करके कार्रवाई तय करता है. यह एक संसाधन को इस फ़ॉर्म के ग्लोबल-यूनीक यूआरआई के ज़रिए बताता है:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
सभी एपीआई संसाधनों के यूनीक एचटीटीपी से ऐक्सेस किए जा सकने वाले यूआरआई होते हैं. इसलिए, REST की मदद से डेटा को कैश मेमोरी में सेव किया जाता है. साथ ही, इसे वेब और उपलब्ध इंफ़्रास्ट्रक्चर के साथ काम करने के लिए ऑप्टिमाइज़ किया जाता है.
आपको एचटीटीपी 1.1 के स्टैंडर्ड दस्तावेज़ों में मैथड की परिभाषाएं काम की लग सकती हैं. इनमें GET, POST, PUT, और DELETE के लिए खास जानकारी शामिल है.
Google Street View पब्लिश एपीआई में REST
Google Street View Publish API ऑपरेशन में सीधे REST HTTP क्रियाओं को मैप किया जाता है.
Google Street View Publish API यूआरआई के लिए खास फ़ॉर्मैट ये हैं:
https://www.googleapis.com/streetviewpublish/v1/resourcePath?parameters
एपीआई में काम करने वाले हर संचालन के लिए इस्तेमाल किए जाने वाले यूआरआई के पूरे सेट की जानकारी Google स्ट्रीट व्यू पब्लिश एपीआई के संदर्भ वाले दस्तावेज़ में दी गई है.
JSON की बुनियादी बातें जानें
Google Street View पब्लिश एपीआई, JSON फ़ॉर्मैट में डेटा दिखाता है.
JSON (JavaScript ऑब्जेक्ट नोटेशन) एक सामान्य डेटा-आधारित डेटा फ़ॉर्मैट है, जो आर्बिट्रेरी डेटा स्ट्रक्चर को टेक्स्ट के रूप में आसान तरीके से दिखाता है. ज़्यादा जानकारी के लिए, json.org देखें.