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