जगह की फ़ोटो

Places API का हिस्सा, जगह की फ़ोटो की सेवा सिर्फ़ पढ़ने के लिए उपलब्ध API है. इसकी मदद से, अपने ऐप्लिकेशन में अच्छी क्वालिटी की फ़ोटो जोड़ी जा सकती हैं. जगह की फ़ोटो की सेवा की मदद से, आपको Places के डेटाबेस में सेव की गई लाखों फ़ोटो का ऐक्सेस मिलता है. जगह की जानकारी का अनुरोध करने पर, आपको उस जगह की फ़ोटो के रेफ़रंस मिलेंगे. जगह ढूंढें, आस-पास की जगहें खोजें, और टेक्स्ट खोज के अनुरोधों पर, हर जगह के लिए एक फ़ोटो का रेफ़रंस भी मिलता है. हालांकि, ऐसा तब ही होता है, जब वह फ़ोटो काम की हो. इसके बाद, Photos की सेवा का इस्तेमाल करके, रेफ़रंस में दी गई फ़ोटो को ऐक्सेस किया जा सकता है. साथ ही, इमेज का साइज़ अपने ऐप्लिकेशन के हिसाब से बदला जा सकता है.

जगह की फ़ोटो के अनुरोध करना

जगह की फ़ोटो का अनुरोध, इस फ़ॉर्मैट का एचटीटीपी यूआरएल होता है:

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

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

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

Place Photo के जवाब

जगह की फ़ोटो का अनुरोध पूरा होने पर, आपको एक इमेज मिलेगी. इमेज का टाइप, मूल रूप से सबमिट की गई फ़ोटो के टाइप पर निर्भर करता है.

अगर आपका अनुरोध, आपके उपलब्ध कोटे से ज़्यादा है, तो सर्वर आपको एचटीटीपी 403 स्टेटस दिखाता है. साथ ही, कोटा से ज़्यादा अनुरोध करने की जानकारी देने के लिए, नीचे दी गई इमेज दिखाता है:

कोटा खत्म होने की जानकारी देने वाली इमेज

अगर सर्वर आपके अनुरोध को समझ नहीं पाता है, तो वह एचटीटीपी 400 वाला स्टेटस दिखाता है. इससे पता चलता है कि अनुरोध अमान्य है. अमान्य अनुरोध की सबसे सामान्य वजहें ये हैं:

  • सबमिट की गई फ़ोटो का रेफ़रंस सही तरीके से नहीं दिया गया था.
  • अनुरोध में maxwidth या maxheight पैरामीटर शामिल नहीं थे.
  • maxwidth या maxheight पैरामीटर की वैल्यू को null पर सेट किया गया था.
  • photo_reference की समयसीमा खत्म हो गई है. अगर photo_reference की समयसीमा खत्म हो जाती है, तो photo_reference की अपडेट की गई वैल्यू पाने के लिए, जगह की जानकारी, जगह ढूंढें, आस-पास खोजें या टेक्स्ट से खोजें के लिए अनुरोध करें.