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

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

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

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

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

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.

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

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