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

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

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

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

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

इसे आज़माएं!

ध्यान दें: जगह की जानकारी (नया) के रिस्पॉन्स बॉडी के photos कलेक्शन में से, जगह name डालें और "कार्रवाई करें" पर क्लिक करें. फ़ोटो देखने के लिए, photoUri वैल्यू का इस्तेमाल करें. यह वैल्यू, जगह की फ़ोटो (नया) के रिस्पॉन्स बॉडी में मौजूद होती है.

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

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

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

यहां दिए गए पैरामीटर ज़रूरी हैं:

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

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

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

फ़ोटो का नाम

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

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

maxHeightPx और maxWidthPx

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

आपको maxHeightPx या maxWidthPx या दोनों की जानकारी देनी होगी.

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

skipHttpRedirect

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

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

यह विकल्प, HTTP के अलावा किसी दूसरे तरीके से किए गए अनुरोधों के लिए अनदेखा कर दिया जाता है.

फ़ोटो का नाम पाना

जगह की फ़ोटो (नया) के सभी अनुरोधों में, फ़ोटो के संसाधन का नाम शामिल होना चाहिए. यह नाम, आस-पास खोजने (नया), टेक्स्ट से खोजने (नया) या जगह की जानकारी (नया) के अनुरोध के जवाब में दिखता है. अगर जगह से जुड़ा फ़ोटो कॉन्टेंट मौजूद है, तो इन अनुरोधों के जवाब में एक 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)(No Caching) में, कैश मेमोरी में डेटा सेव करने से जुड़ी पाबंदियां देखें.

नीचे दिए गए उदाहरण में, जगह की जानकारी (नया) का अनुरोध दिखाया गया है. इसमें फ़ील्ड मास्क में 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. पेज की दाईं ओर मौजूद, एपीआई आइकॉन api चुनें.
2. name पैरामीटर को इन पर सेट करें:

   places/PLACE_ID/photos/PHOTO_RESOURCE/media

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

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