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

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

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 स्टेटस दिखाता है. इससे पता चलता है कि अनुरोध अमान्य है. अमान्य अनुरोध की सबसे आम वजहें ये हैं: