जगह की फ़ोटो (नया) सेवा, रीड-ओनली एपीआई है. इसकी मदद से, अपने ऐप्लिकेशन में अच्छी क्वालिटी का फ़ोटोग्राफ़िक कॉन्टेंट जोड़ा जा सकता है. 'जगह की फ़ोटो' सेवा की मदद से, आपको Places के डेटाबेस में सेव की गई लाखों फ़ोटो का ऐक्सेस मिलता है.
जब आपको जगह की जानकारी, आस-पास खोजने या टेक्स्ट से खोजने के अनुरोध का इस्तेमाल करके मिलती है, तो आपके पास काम के फ़ोटो कॉन्टेंट के लिए फ़ोटो संसाधनों का अनुरोध करने का विकल्प भी होता है. इसके बाद, फ़ोटो सेवा का इस्तेमाल करके, रेफ़रंस में दी गई फ़ोटो ऐक्सेस की जा सकती हैं. साथ ही, इमेज का साइज़ अपने ऐप्लिकेशन के हिसाब से बदला जा सकता है.
एपीआई एक्सप्लोरर की मदद से, लाइव अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है:
इसे आज़माएं!जगह की फ़ोटो के अनुरोध
स्थान फ़ोटो अनुरोध किसी URL के लिए एक HTTP GET अनुरोध होता है, जो इस रूप में होता है:https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS
जहां ये पैरामीटर ज़रूरी होते हैं:
- NAME में फ़ोटो के संसाधन का नाम होता है.
- API_KEY में एपीआई पासकोड होता है.
- PARAMETERS में
maxHeightPx
पैरामीटर,maxWidthPx
पैरामीटर या दोनों शामिल होते हैं.
ज़रूरी और वैकल्पिक पैरामीटर की पूरी सूची यहां दी गई है.
ज़रूरी पैरामीटर
फ़ोटो का नाम
एक स्ट्रिंग आइडेंटिफ़ायर, जो किसी फ़ोटो की खास तौर पर पहचान करता है. फ़ोटो के नाम, photos[]
कलेक्शन के हर एलिमेंट की name
प्रॉपर्टी में, जगह की जानकारी (नई), आस-पास खोजने की सुविधा (नई) या टेक्स्ट से खोजने की सुविधा (नई) के अनुरोध से मिलते हैं.
उदाहरण के लिए, फ़ोटो का नाम पाना देखें.
maxHeightPx और maxWidthPx
इमेज की ऊंचाई और चौड़ाई, पिक्सल में तय करता है. अगर इमेज, तय की गई वैल्यू से छोटी है, तो ओरिजनल इमेज दिखा दी जाएगी. अगर इमेज का कोई डाइमेंशन बड़ा है, तो उसे छोटे डाइमेंशन के हिसाब से स्केल किया जाएगा. हालांकि, इमेज का आसपेक्ट रेशियो नहीं बदला जाएगा. maxheight और maxwidth, दोनों प्रॉपर्टी के लिए 1 से 4800 के बीच की कोई पूर्ण संख्या डाली जा सकती है.
आपको maxHeightPx
या maxWidthPx
या दोनों की जानकारी देनी होगी.
ज़रूरी नहीं पैरामीटर
skipHttpRedirect
अगर false
(डिफ़ॉल्ट) है, तो इमेज को वापस लाने के लिए, इमेज पर HTTP रीडायरेक्ट करें.
अगर true
है, तो रीडायरेक्ट को छोड़ें और इमेज की जानकारी वाला JSON रिस्पॉन्स दें.
उदाहरण के लिए:
{ "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/Aaw_FcKly0DEv3EWmDJyHiEqXIP5mowOc99lN1GzBun6KHH52AZ5fFA/media", "photoUri": "https://lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo" }
बिना एचटीटीपी वाले अनुरोधों के लिए इस विकल्प को अनदेखा कर दिया जाता है.
फ़ोटो का नाम पाना
जगह की फ़ोटो की सेवा के लिए किए गए सभी अनुरोधों में, फ़ोटो के रिसॉर्स का नाम शामिल होना चाहिए. यह नाम, आस-पास खोजने, टेक्स्ट से खोजने या जगह की जानकारी के अनुरोध के जवाब में दिखता है. अगर जगह से जुड़ी फ़ोटोग्राफ़िक कॉन्टेंट है, तो इन अनुरोधों के रिस्पॉन्स में photos[]
कलेक्शन शामिल होता है.
photo[]
के हर एलिमेंट में ये फ़ील्ड होते हैं:
name
— फ़ोटो का अनुरोध करने पर, फ़ोटो के संसाधन का नाम दिखाने वाली स्ट्रिंग. यह स्ट्रिंग इस फ़ॉर्मैट में होती है:places/PLACE_ID/photos/PHOTO_RESOURCE
heightPx
— इमेज की ज़्यादा से ज़्यादा ऊंचाई, पिक्सल में.widthPx
— पिक्सल में इमेज की ज़्यादा से ज़्यादा चौड़ाई.authorAttributions[]
— ज़रूरी एट्रिब्यूशन. यह फ़ील्ड हमेशा मौजूद होता है, लेकिन हो सकता है कि यह खाली हो.
फ़ोटो की सेवा से मिली फ़ोटो, कई जगहों से ली जाती हैं. इनमें, कारोबार के मालिकों और उपयोगकर्ताओं की दी गई फ़ोटो भी शामिल हैं. ज़्यादातर मामलों में, इन फ़ोटो का इस्तेमाल
जानकारी देने के बिना किया जा सकता है या इन्हें इमेज के हिस्से के तौर पर
ज़रूरी एट्रिब्यूशन दिया जाएगा. हालांकि, अगर दिखाए गए photo
एलिमेंट में authorAttributions
फ़ील्ड में कोई वैल्यू शामिल है, तो आपको अपने ऐप्लिकेशन में जहां भी इमेज दिखाई जाती है वहां अतिरिक्त एट्रिब्यूशन शामिल करना होगा.
इस उदाहरण में, जगह की जानकारी का एक अनुरोध दिखाया गया है. इस अनुरोध में फ़ील्ड मास्क में photos
शामिल है, ताकि रिस्पॉन्स में photos[]
अरे शामिल हो:
curl -X GET \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,photos" \ https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E
photos[]
कलेक्शन का उदाहरण नीचे दिया गया है.
... "photos" : [ { "name": "places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1", "widthPx": 6000, "heightPx": 4000, "authorAttributions": [ { "displayName": "John Smith", "uri": "//maps.google.com/maps/contrib/101563", "photoUri": "//lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo" } ] }, ...
किसी जगह की फ़ोटो का अनुरोध करना
यहां दिए गए अनुरोध के उदाहरण में, संसाधन name
का इस्तेमाल करके इमेज दिखाई गई है. साथ ही, इमेज का साइज़ बदला गया है, ताकि वह ज़्यादा से ज़्यादा 400 पिक्सल लंबी और चौड़ी हो:
https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY
जगह की फ़ोटो का अनुरोध पूरा होने पर, जवाब के तौर पर एक इमेज मिलती है. इमेज का टाइप, मूल रूप से सबमिट की गई फ़ोटो के टाइप पर निर्भर करता है.
अगर आपका अनुरोध, आपके उपलब्ध कोटे से ज़्यादा है, तो सर्वर आपको एचटीटीपी 403 स्टेटस दिखाएगा. साथ ही, कोटा से ज़्यादा अनुरोध करने की जानकारी देने के लिए, नीचे दी गई इमेज दिखाएगा:
अगर सर्वर आपके अनुरोध को नहीं समझ पाता है, तो यह एचटीटीपी 400 स्थिति दिखाता है. इससे, अमान्य अनुरोध का पता चलता है. अमान्य अनुरोध की सबसे सामान्य वजहें ये हैं:
- सबमिट की गई फ़ोटो का नाम सही तरीके से नहीं बताया गया था.
- अनुरोध में
maxHeightPx
याmaxWidthPx
पैरामीटर शामिल नहीं था. maxHeightPx
याmaxWidthtPx
पैरामीटर की वैल्यू कोnull
पर सेट किया गया था.name
की समयसीमा खत्म हो गई है. अगरname
की समयसीमा खत्म हो जाती है, तो नयाname
पाने के लिए जगह की जानकारी (नया), आस-पास खोजने की सुविधा (नया) या टेक्स्ट सर्च (नया) के लिए अनुरोध करें.
इसे आज़माएं!
एपीआई एक्सप्लोरर की मदद से, सैंपल अनुरोध किए जा सकते हैं, ताकि आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिल सके.
अनुरोध करने के लिए:
- पेज के दाईं ओर मौजूद, एपीआई आइकॉन को चुनें.
name
पैरामीटर को इस पर सेट करें:places/PLACE_ID/photos/PHOTO_RESOURCE/media
skipHttpRedirect
कोtrue
पर सेट करें, ताकि अनुरोध से JSON रिस्पॉन्स मिले. डिफ़ॉल्ट रूप से, अनुरोध से वह इमेज मिलती है जिसे एपीआई एक्सप्लोरर से नहीं दिखाया जा सकता.- लागू करें बटन चुनें. पॉप-अप में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.
एपीआई एक्सप्लोरर पैनल में, एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, बड़ा करें आइकॉन, चुनें.