जगह की फ़ोटो (नई)

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

जगह की फ़ोटो (नया) सेवा, सिर्फ़ पढ़ने के लिए एपीआई है. इससे अपने ऐप्लिकेशन में अच्छी क्वालिटी का फ़ोटोग्राफ़िक कॉन्टेंट जोड़ा जा सकता है. स्थान फ़ोटो सेवा आपको स्थल डेटाबेस में संग्रहित लाखों फ़ोटो की ऐक्सेस देती है.

जब आपको किसी स्थान विवरण, आस-पास खोज या टेक्स्ट खोज अनुरोध का उपयोग करके स्थान की जानकारी मिलती है, तो आप प्रासंगिक फ़ोटोग्राफ़िक सामग्री के लिए फ़ोटो संसाधनों का अनुरोध भी कर सकते हैं. फिर फ़ोटो सेवा का इस्तेमाल करके, आप रेफ़र की गई फ़ोटो ऐक्सेस कर सकते हैं और इमेज को अपने ऐप्लिकेशन के मुताबिक सही साइज़ में बदल सकते हैं.

एपीआई एक्सप्लोरर की मदद से लाइव अनुरोध किए जा सकते हैं, ताकि आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिल सके:

इसे आज़माएं!

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

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

https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS

जहां ये पैरामीटर ज़रूरी होते हैं:

• NAME में फ़ोटो के संसाधन का नाम होता है.
• API_KEY में एपीआई पासकोड शामिल है.
• PARAMETERS में maxHeightPx पैरामीटर, maxWidthPx पैरामीटर या दोनों शामिल होते हैं.

ज़रूरी और वैकल्पिक पैरामीटर की पूरी सूची नीचे दी गई है.

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

फ़ोटो नाम

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

उदाहरण के लिए, फ़ोटो का नाम पाएं देखें.

MaxHightPx और maxWidthPx

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

आपको maxHeightPx या maxWidthPx या दोनों के बारे में बताना होगा.

ज़रूरी नहीं पैरामीटर

skipHttpRedirect

अगर false (डिफ़ॉल्ट) है, तो इमेज वापस करने के लिए इमेज पर एक एचटीटीपी रीडायरेक्ट करें. अगर true, तो रीडायरेक्ट को छोड़ें और इमेज की खराबियों के साथ JSON रिस्पॉन्स दें. उदाहरण के लिए:

{
  "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/Aaw_FcKly0DEv3EWmDJyHiEqXIP5mowOc99lN1GzBun6KHH52AZ5fFA/media",
  "photoUri": "https://lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo"
}

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

फ़ोटो को कोई नाम दें

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

ध्यान दें: रिस्पॉन्स में photos[] कलेक्शन को शामिल करने के लिए, अनुरोध के फ़ील्ड मास्क में photos (जगह की जानकारी) याplaces.photos (आस-पास खोजने की सुविधा और टेक्स्ट से जुड़ी खोज) को शामिल करना न भूलें. हर एपीआई, किसी जगह की जगह के लिए ज़्यादा से ज़्यादा 10 फ़ोटो दिखा सकता है.

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

• name — फ़ोटो का अनुरोध करने पर, इस स्ट्रिंग में फ़ोटो का संसाधन नाम होता है. यह स्ट्रिंग इस रूप में है:

  places/PLACE_ID/photos/PHOTO_RESOURCE

• heightPx — पिक्सल में इमेज की ज़्यादा से ज़्यादा ऊंचाई.
• widthPx — पिक्सल में इमेज की ज़्यादा से ज़्यादा चौड़ाई.
• authorAttributions[] — सभी ज़रूरी एट्रिब्यूशन. यह फ़ील्ड हमेशा मौजूद होता है, लेकिन हो सकता है कि यह खाली हो.

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

चेतावनी: किसी फ़ोटो का नाम कैश मेमोरी में सेव नहीं किया जा सकता. साथ ही, नाम की समयसीमा खत्म हो सकती है. पक्का करें कि आपको हमेशा जवाब में दिया गया नाम, जगह की जानकारी (नया), आस-पास की खोज (नया) या टेक्स्ट सर्च (नया) से जुड़े अनुरोध के जवाब में मिला हो. ज़्यादा जानकारी के लिए, Google Maps Platform की सेवा की शर्तों के सेक्शन 3.2.3(b)(कोई कैश नहीं किया जा रहा है) में बताए गए कैश मेमोरी में डेटा सेव करने की पाबंदियां देखें.

इस उदाहरण में, जगह की जानकारी का एक अनुरोध दिखाया गया है. इस अनुरोध में फ़ील्ड मास्क में photos शामिल है, ताकि रिस्पॉन्स में photos[] अरे शामिल हो:

curl -X GET \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,photos" \
https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E

जवाब में photos[] कलेक्शन का एक उदाहरण नीचे दिया गया है.

    ...
    "photos" : [
      {
        "name": "places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1",
        "widthPx": 6000,
        "heightPx": 4000,
        "authorAttributions": [
          {
            "displayName": "John Smith",
            "uri": "//maps.google.com/maps/contrib/101563",
            "photoUri": "//lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo"
          }
        ]
      },    ...

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

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

https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY

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

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

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

• सबमिट की गई फ़ोटो का नाम सही तरीके से नहीं बताया गया था.
• अनुरोध में maxHeightPx या maxWidthPx पैरामीटर शामिल नहीं था.
• maxHeightPx या maxWidthtPx पैरामीटर की वैल्यू को null पर सेट किया गया था.
• name की समयसीमा खत्म हो गई है. अगर name की समयसीमा खत्म हो जाती है, तो नया name पाने के लिए जगह की जानकारी (नया), आस-पास खोजने की सुविधा (नया) या टेक्स्ट सर्च (नया) के लिए अनुरोध करें.

इसे आज़माएं!

एपीआई एक्सप्लोरर से आपको सैंपल के तौर पर अनुरोध करने की सुविधा मिलती है. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.

अनुरोध करने के लिए:

1. पेज के दाईं ओर मौजूद, एपीआई आइकॉन को चुनें.
2. name पैरामीटर को इस पर सेट करें:

   places/PLACE_ID/photos/PHOTO_RESOURCE/media

   ध्यान दें: पक्का करें कि आप जगह की हाल ही की जानकारी के अनुरोध के लिए name का इस्तेमाल कर रहे हैं, क्योंकि name की समयसीमा खत्म हो सकती है.
3. skipHttpRedirect को true पर सेट करें, ताकि अनुरोध से JSON रिस्पॉन्स मिले. डिफ़ॉल्ट रूप से, अनुरोध ऐसी इमेज दिखाता है जिसे एपीआई एक्सप्लोरर में नहीं दिखाया जा सकता.
4. लागू करें बटन चुनें. पॉप-अप में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.

5. एपीआई एक्सप्लोरर पैनल में, एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, 'बड़ा करें' आइकॉन चुनें.