जगह की फ़ोटो (लेगसी)

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

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

Place Photos (लेगसी) के अनुरोध

Place Photos (लेगसी) का अनुरोध, इस तरह का एचटीटीपी यूआरएल होता है:

https://maps.googleapis.com/maps/api/place/photo?parameters

खोज का अनुरोध शुरू करने के लिए, कुछ पैरामीटर ज़रूरी होते हैं. यूआरएल में स्टैंडर्ड के तौर पर, सभी पैरामीटर को एंपरसैंड (&) वर्ण का इस्तेमाल करके अलग किया जाता है. पैरामीटर और उनकी संभावित वैल्यू की सूची यहां दी गई है.

ज़रूरी पैरामीटर

  • photo_reference

    यह एक स्ट्रिंग आइडेंटिफ़ायर है, जो किसी फ़ोटो की खास तौर पर पहचान करता है. फ़ोटो के रेफ़रंस, Place Search या Place Details के अनुरोध से मिलते हैं.

  • maxheight या maxwidth

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

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

    maxheight और maxwidth, दोनों प्रॉपर्टी के लिए 1 और 1600 के बीच का कोई पूर्णांक इस्तेमाल किया जा सकता है.

    आपको maxheight या maxwidth या दोनों में से किसी एक की वैल्यू देनी होगी.

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

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

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

  • Find Place (लेगसी)', आस-पास की जगहों की जानकारी (लेगसी) या टेक्स्ट से खोजें (लेगसी)' अनुरोध करने पर, जवाब में ज़्यादा से ज़्यादा एक photo एलिमेंट मिलता है.
  • जगह के बारे में ज़्यादा जानकारी (लेगसी) के अनुरोध पर, ज़्यादा से ज़्यादा दस photo एलिमेंट मिलते हैं.

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

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

Place Photos (लेगसी) से मिली फ़ोटो, अलग-अलग जगहों से ली जाती हैं. इनमें, कारोबार के मालिकों और उपयोगकर्ताओं की ओर से अपलोड की गई फ़ोटो शामिल हैं. ज़्यादातर मामलों में, इन फ़ोटो का इस्तेमाल बिना एट्रिब्यूशन के किया जा सकता है. इसके अलावा, ज़रूरी एट्रिब्यूशन को इमेज के हिस्से के तौर पर शामिल किया जाएगा. हालांकि, अगर दिखाए गए 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"
       }]
    ...

Place Photos (लेगसी) का उदाहरण

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

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

Place Photos (लेगसी) के जवाब

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

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

कोटा पूरा होने की जानकारी देने वाली इमेज

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