जगह की फ़ोटो

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript वेब सेवा

'प्लेस फ़ोटो' सेवा, 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 and maxwidth properties accept an integer between 1 and 1600.

    You must specify either maxheight, or maxwidth, or both.

फ़ोटो के रेफ़रंस

जगह की फ़ोटो से जुड़ी सेवा के सभी अनुरोधों में photo_reference शामिल होना चाहिए. यह जगह ढूंढने, आस-पास की खोज, टेक्स्ट खोज या जगह की जानकारी से जुड़े अनुरोध के जवाब में दिखाया जाना चाहिए. अगर जगह की फ़ोटो से जुड़ा कॉन्टेंट है, तो इन अनुरोधों के जवाब में एक photos[] फ़ील्ड शामिल होगा.

ध्यान दें: अनुरोध के हिसाब से, अलग-अलग फ़ोटो वापस लाई जा सकती हैं.

  • जगह ढूंढें, आस-पास खोज या टेक्स्ट खोजने के अनुरोध से, कलेक्शन में ज़्यादा से ज़्यादा एक photo एलिमेंट दिखता है.
  • जगह की जानकारी का अनुरोध करने पर, ज़्यादा से ज़्यादा दस photo एलिमेंट दिखेंगे.

हर photo एलिमेंट में ये फ़ील्ड शामिल होते हैं:

  • photo_reference — यह एक स्ट्रिंग है, जिसका इस्तेमाल फ़ोटो से जुड़ा अनुरोध किए जाने पर, फ़ोटो की पहचान करने के लिए किया जाता है.
  • height — इमेज की ज़्यादा से ज़्यादा ऊंचाई.
  • width — इमेज की ज़्यादा से ज़्यादा चौड़ाई.
  • html_attributions[] — में सभी ज़रूरी एट्रिब्यूशन शामिल हैं. यह फ़ील्ड हमेशा मौजूद रहेगा, लेकिन हो सकता है कि यह खाली हो.

फ़ोटो सेवा की ओर से दी गई फ़ोटो कई तरह की जगहों से ली जाती हैं. इनमें कारोबार के मालिक और उपयोगकर्ताओं ने जो फ़ोटो अपलोड की हैं वे भी शामिल हैं. ज़्यादातर मामलों में, इन फ़ोटो का इस्तेमाल एट्रिब्यूशन के बिना किया जा सकता है या इनमें ज़रूरी एट्रिब्यूशन को इमेज के हिस्से के रूप में शामिल किया जाएगा. हालांकि, अगर दिखाए गए photo एलिमेंट के html_attributions फ़ील्ड में कोई वैल्यू शामिल है, तो आपको अपने ऐप्लिकेशन में जहां भी इमेज दिखाई जाए, वहां अतिरिक्त एट्रिब्यूशन शामिल करना होगा.

के सेक्शन 5.4 में बताए गए, कैश मेमोरी में डेटा सेव करने से जुड़ी पाबंदियां देखें

नीचे दिए गए उदाहरण में, जगह की जानकारी का अनुरोध दिखाया गया है:

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 की अपडेट की गई वैल्यू पाने के लिए, जगह की जानकारी, जगह ढूंढें, आस-पास खोज की सुविधा या Text Search का अनुरोध करें.