जगह की फ़ोटो

प्लैटफ़ॉर्म चुनें: 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 फ़ील्ड में कोई वैल्यू शामिल है, तो आपको जहां भी इमेज दिखाई जाए वहां अपने ऐप्लिकेशन में अतिरिक्त एट्रिब्यूशन शामिल करना होगा.

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

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1"
   }
...

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

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

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1&key=YOUR_API_KEY

जगह की फ़ोटो से जुड़े जवाब

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

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

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

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

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