जगह की फ़ोटो

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript वेब सेवा

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

जगह की फ़ोटो जोड़ने के अनुरोध

स्थान की फ़ोटो का अनुरोध नीचे दिए गए फ़ॉर्म का एक HTTP यूआरएल है:

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

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

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 एलिमेंट मिलता है करते हैं.
  • जगह की जानकारी के अनुरोध में, ज़्यादा से ज़्यादा 10 photo एलिमेंट दिखते हैं.

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

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

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

नीचे दिए गए उदाहरण में, जगह की जानकारी का अनुरोध दिखाया गया है:

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"
   }
...

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

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

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

जगह की फ़ोटो का जवाब

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

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

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

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

  • सबमिट की गई फ़ोटो का रेफ़रंस, सही तरीके से नहीं दिया गया है.
  • अनुरोध में maxwidth या maxheight शामिल नहीं थे पैरामीटर का इस्तेमाल करें.
  • maxwidth या maxheight पैरामीटर के लिए वैल्यू सेट की गई null के लिए.
  • photo_reference की समयसीमा खत्म हो गई है. अगर photo_reference की समयसीमा खत्म हो जाती है, तो जगह की जानकारी के लिए अनुरोध, जगह ढूंढें, आस-पास खोज, या टेक्स्ट खोज photo_reference की अपडेट की गई वैल्यू पाने के लिए.