Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

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

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

परिचय

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

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

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

इसे आज़माएं!

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

Place Photos (नई) के अनुरोध

Place Photos (नया) का अनुरोध, इस तरह के यूआरएल के लिए एचटीटीपी 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 (डिफ़ॉल्ट) है, तो इमेज वापस पाने के लिए इमेज पर एचटीटीपी रीडायरेक्ट करें. अगर true, तो रीडायरेक्ट करने की प्रोसेस को छोड़ दें और इमेज की जानकारी देने वाला JSON रिस्पॉन्स दिखाएं. उदाहरण के लिए:

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

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

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

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

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

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

name — यह एक स्ट्रिंग है. इसमें फ़ोटो का संसाधन नाम होता है. यह तब दिखता है, जब फ़ोटो का अनुरोध किया जाता है. यह स्ट्रिंग इस फ़ॉर्म में होती है:
```
places/PLACE_ID/photos/PHOTO_RESOURCE
```
heightPx — पिक्सल में इमेज की ज़्यादा से ज़्यादा ऊंचाई.
widthPx — पिक्सल में इमेज की ज़्यादा से ज़्यादा चौड़ाई.
authorAttributions[] — ज़रूरी एट्रिब्यूशन. यह फ़ील्ड हमेशा मौजूद होता है, लेकिन हो सकता है कि यह खाली हो.

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

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

यहां Place Details (नया) के अनुरोध का उदाहरण दिया गया है. इसमें फ़ील्ड मास्क में 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/ATKogpeivkIjQ1FT7QmbeT33nBSwqLhdPvIWHfrG1WfmgrFjeZYpS_Ls7c7rj8jejN9QGzlx4GoAH0atSvUzATDrgrZic_tTEJdeITdWL-oG3TWi5HqZoLozrjTaxoAIxmROHfV5KXVcLeTdCC6kmZExSy0CLVIG3lAPIgmvUiewNf-ZHYE4-jXYwPQpWHJgqVosvZJ6KWEgowEA-qRAzNTu9VH6BPFqHakGQ7EqBAeYOiU8Dh-xIQC8FcBJiTi0xB4tr-MYXUaF0p_AqzAhJcDE6FAgLqG1s7EsME0o36w2nDRHA-IuoISBC3SIahINE3Xwq2FzEZE6TpNTFVfgTpdPhV8CGLeqrauHn2I6ePm-2hA8-87aO7aClXKJJVzlQ1dc_JuHz6Ks07d2gglw-ZQ3ibCTF5lMtCF9O-9JHyRQXsfuXw/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY

Place Photos (New) के अनुरोध के पूरा होने पर, जवाब के तौर पर एक इमेज मिलती है.

गड़बड़ी के कोड

Place Photos (New) के अनुरोधों के लिए, ये गड़बड़ी कोड दिख सकते हैं.

कोटा पूरा हो गया है (403)

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

अमान्य अनुरोध (404)

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

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

बहुत ज़्यादा अनुरोध (429)

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

इसे आज़माएं!

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

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

पेज की दाईं ओर मौजूद, एपीआई आइकॉन को चुनें.
name पैरामीटर को इस पर सेट करें:
```
places/PLACE_ID/photos/PHOTO_RESOURCE/media
```
ध्यान दें: पक्का करें कि आपने हाल ही में किए गए जगह की जानकारी (नया) के अनुरोध से मिला name इस्तेमाल किया हो. ऐसा इसलिए, क्योंकि name की समयसीमा खत्म हो सकती है.
skipHttpRedirect को true पर सेट करें, ताकि अनुरोध JSON रिस्पॉन्स दिखा सके. डिफ़ॉल्ट रूप से, अनुरोध में इमेज दिखती है. इसे एपीआई एक्सप्लोरर नहीं दिखा सकता.
लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.
एपीआई एक्सप्लोरर पैनल में, फ़ुलस्क्रीन आइकॉन को चुनें. इससे एपीआई एक्सप्लोरर विंडो बड़ी हो जाएगी.