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

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

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

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

इसे आज़माएं!

फ़ोटो के लिए अनुरोध करें

जगह की फ़ोटो का अनुरोध, एक एचटीटीपी जीईटी अनुरोध होता है, जो किसी यूआरएल के लिए अनुरोध होता है. यह अनुरोध फ़ॉर्म में मौजूद होता है:
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"
}

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

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

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

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

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

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

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

नीचे दिए गए उदाहरण में, जगह की जानकारी का अनुरोध दिखाया गया है. इसमें फ़ील्ड मास्क में 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. name पैरामीटर को इस पर सेट करें:
    places/PLACE_ID/photos/PHOTO_RESOURCE/media
  2. skipHttpRedirect को true पर सेट करें, ताकि अनुरोध करने पर JSON रिस्पॉन्स दिखे. डिफ़ॉल्ट रूप से, अनुरोध करने पर इमेज दिखती है, जो एपीआई एक्सप्लोरर पर नहीं दिखाई जा सकती.
  3. लागू करें बटन को चुनें. पॉप-अप में, वह खाता चुनें जिसका इस्तेमाल आपको अनुरोध करने के लिए करना है.