स्थल फ़ोटो सेवा, Places API का हिस्सा है, एक रीड-ओनली एपीआई है. इसकी मदद से आप अपने ऐप्लिकेशन में अच्छी क्वालिटी का फ़ोटोग्राफ़िक कॉन्टेंट जोड़ सकते हैं. स्थान फ़ोटो सेवा आपको स्थान डेटाबेस में संग्रहित लाखों फ़ोटो की ऐक्सेस देती है. जब आपको जगह की जानकारी मांगने के लिए जगह की जानकारी मिलती है, तो उससे जुड़ी फ़ोटोग्राफ़िक कॉन्टेंट के लिए फ़ोटो के रेफ़रंस दिए जाएंगे. जगह, आस-पास की जाने वाली खोज, और टेक्स्ट खोज के अनुरोध भी, उपयोगी होने पर हर जगह के लिए एक फ़ोटो रेफ़रंस भी देते हैं. फ़ोटो सेवा का इस्तेमाल करके, रेफ़रंस के तौर पर दी गई फ़ोटो ऐक्सेस की जा सकती हैं. साथ ही, इमेज का साइज़ बदलकर ऐप्लिकेशन के हिसाब से सही साइज़ में बदला जा सकता है.
फ़ोटो जोड़ने के अनुरोध
जगह की फ़ोटो का अनुरोध, नीचे दिए गए फ़ॉर्म का एचटीटीपी यूआरएल होता है:
https://maps.googleapis.com/maps/api/place/photo?parameters
खोज का अनुरोध करने के लिए, कुछ पैरामीटर ज़रूरी होते हैं. जैसा कि यूआरएल में स्टैंडर्ड तरीके से किया जाता है, सभी पैरामीटर को ऐंपरसेंड (&
) वर्ण का इस्तेमाल करके अलग किया जाता है. पैरामीटर की सूची और उनकी संभावित वैल्यू नीचे दी गई हैं.
Required parameters
photo_reference
A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.
maxheight or maxwidth
maxheight
specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.maxwidth
specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.Both the
maxheight
andmaxwidth
properties accept an integer between1
and1600
.You must specify either
maxheight
, ormaxwidth
, or both.
फ़ोटो के रेफ़रंस
'जगह की फ़ोटो' सेवा को दिए जाने वाले सभी अनुरोधों में photo_reference
शामिल होना चाहिए. यह
जगह ढूंढने, आस-पास की जाने वाली खोज, टेक्स्ट खोजने या जगह की जानकारी
की जानकारी मांगने के जवाब में दिया जाना चाहिए. अगर जगह पर उससे जुड़ा फ़ोटोग्राफ़िक कॉन्टेंट है, तो इन अनुरोधों के जवाब में photos[]
फ़ील्ड शामिल किया जाएगा.
ध्यान दें: अनुरोध के हिसाब से, फ़ोटो की संख्या अलग-अलग हो सकती है.
- जगह ढूंढने, आस-पास खोजने या टेक्स्ट खोजने के अनुरोध से, अरे में ज़्यादा से ज़्यादा एक
photo
एलिमेंट दिखता है. - जगह की जानकारी के अनुरोध से, ज़्यादा से ज़्यादा दस
photo
एलिमेंट दिखाए जा सकते हैं.
हर photo
एलिमेंट में ये फ़ील्ड शामिल होते हैं:
photo_reference
— इस स्ट्रिंग का इस्तेमाल फ़ोटो की पहचान करने के लिए किया जाता है.height
— इमेज की ज़्यादा से ज़्यादा ऊंचाई.width
— इमेज की ज़्यादा से ज़्यादा चौड़ाई.html_attributions[]
— में सभी ज़रूरी एट्रिब्यूशन शामिल हैं. यह फ़ील्ड हमेशा मौजूद रहेगा, लेकिन खाली हो सकता है.
फ़ोटो सेवा की ओर से दी गई फ़ोटो कई जगहों से ली गई हैं. इनमें कारोबार के मालिक और उपयोगकर्ता के योगदान वाली फ़ोटो शामिल हैं. ज़्यादातर मामलों में, इन फ़ोटो को एट्रिब्यूशन के बिना इस्तेमाल किया जा सकता है या इमेज के हिस्से के तौर पर, ज़रूरी एट्रिब्यूशन को शामिल किया जाएगा. हालांकि, अगर लौटाए गए photo
एलिमेंट के लिए html_attributions
फ़ील्ड में कोई वैल्यू शामिल की जाती है, तो जहां भी इमेज दिखाई जाएगी वहां आपको अपने ऐप्लिकेशन में अतिरिक्त एट्रिब्यूशन शामिल करना होगा.
नीचे दिए गए उदाहरण में, जगह की जानकारी का अनुरोध दिखाया गया है:
curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"
रिस्पॉन्स में photos[]
कलेक्शन का एक उदाहरण नीचे दिखाया गया है.
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
}
...
जगह की फ़ोटो का उदाहरण
अनुरोध का एक उदाहरण नीचे दिया गया है. यह अनुरोध रेफ़र की गई इमेज को वापस लौटाएगा, इसका साइज़ बदलें, ताकि उसकी चौड़ाई ज़्यादा से ज़्यादा 400 पिक्सल की हो.
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q &key=YOUR_API_KEY
जगह की फ़ोटो से जुड़ा जवाब
जगह की फ़ोटो का अनुरोध स्वीकार होने पर, मिलने वाला रिस्पॉन्स एक इमेज के तौर पर दिखेगा. इमेज किस तरह की है, यह इस बात पर निर्भर करेगा कि सबमिट की गई फ़ोटो किस तरह की है.
अगर आपका अनुरोध, आपके उपलब्ध कोटा से ज़्यादा हो जाता है, तो सर्वर एचटीटीपी 403 स्टेटस दिखाएगा. साथ ही, नीचे दी गई इमेज दिखाएगा, जिसमें यह बताया जाएगा कि कोटा पूरा हो गया है:
अगर सर्वर आपके अनुरोध को नहीं समझ पाता है, तो वह एचटीटीपी 400 की स्थिति दिखाता है. इससे पता चलता है कि अनुरोध अमान्य है. किसी अमान्य अनुरोध की सबसे सामान्य वजहों में ये शामिल हैं:
- सबमिट की गई फ़ोटो का रेफ़रंस सही तरीके से नहीं दिया गया है.
- अनुरोध में
maxwidth
याmaxheight
पैरामीटर शामिल नहीं थे. maxwidth
याmaxheight
पैरामीटर की वैल्यू कोnull
पर सेट किया गया था.photo_reference
की समयसीमा खत्म हो गई है. अगरphoto_reference
की समयसीमा खत्म हो जाती है, तोphoto_reference
की अपडेट की गई वैल्यू पाने के लिए, जगह की जानकारी, जगह ढूंढें, आस-पास खोजने की सुविधा या टेक्स्ट खोज का अनुरोध करें.