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

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

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

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

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