जगह की फ़ोटो

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

Places API का हिस्सा 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.

Optional parameters

  • 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. Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

  • 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.

Generated from the OpenAPI specification. Edit Report bug

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

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

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

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

हर photo एलिमेंट में ये फ़ील्ड होंगे:

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

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

photos[] कलेक्शन का एक उदाहरण नीचे दिखाया गया है.

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
   }
...

जगह की फ़ोटो का उदाहरण

अनुरोध का एक उदाहरण नीचे दिखाया गया है. इस अनुरोध में, 400 पिक्सल चौड़ी चौड़ाई वाले साइज़ की इमेज का साइज़ दिखेगा.

https://maps.googleapis.com/maps/api/place/photo
  ?maxwidth=400
  &photo_reference=Aap_uEA7vb0DDYVJWEaX3O-AtYp77AaswQKSGtDaimt3gt7QCNpdjp1BkdM6acJ96xTec3tsV_ZJNL_JP-lqsVxydG3nh739RE_hepOOL05tfJh2_ranjMadb3VoBYFvF0ma6S24qZ6QJUuV6sSRrhCskSBP5C1myCzsebztMfGvm7ij3gZT
  &key=YOUR_API_KEY

जगह की फ़ोटो का जवाब

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

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

कोटा से ज़्यादा इमेज

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

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