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

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

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

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

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

इसे आज़माएं!

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

स्थान फ़ोटो अनुरोध किसी URL के लिए एक HTTP GET अनुरोध होता है, जो इस रूप में होता है:

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 की सेवा की शर्तें.

नीचे दिए गए उदाहरण में, जगह की जानकारी का अनुरोध दिखाया गया है. इसमें 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 की समयसीमा खत्म हो जाती है, तो जगह की जानकारी (नया), आस-पास खोजने की सुविधा (नया) के लिए अनुरोध, या Text Search (नया) का इस्तेमाल एक नया name.

इसे आज़माएं!

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

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

1. एपीआई का आइकॉन चुनें. पर क्लिक करें.
2. name पैरामीटर को इस पर सेट करें:

   places/PLACE_ID/photos/PHOTO_RESOURCE/media

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

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