जगह की जानकारी देने वाली सेवा, एपीआई एपीआई का हिस्सा है. यह सिर्फ़ पढ़ने के लिए एपीआई है और इसकी मदद से ऐप्लिकेशन में अच्छी क्वालिटी का फ़ोटोग्राफ़िक कॉन्टेंट जोड़ा जा सकता है. जगह की फ़ोटो सेवा की मदद से, Places डेटाबेस में सेव की गई लाखों फ़ोटो को ऐक्सेस किया जा सकता है. जब आप किसी जगह की जानकारी के अनुरोध का इस्तेमाल करके जगह की जानकारी पाते हैं, तो काम के फ़ोटोग्राफ़िक कॉन्टेंट के लिए फ़ोटो के रेफ़रंस दिखाए जाते हैं. जगह ढूंढें, आस-पास की जगहें खोजने, और टेक्स्ट खोजने के अनुरोधों के ज़रिए, हर जगह के लिए एक ही फ़ोटो का संदर्भ दिया जाता है. फिर फ़ोटो सेवा का उपयोग करके आप अपने ऐप्लिकेशन के लिए संदर्भित फ़ोटो ऐक्सेस कर सकते हैं और चित्र का आकार उचित आकार में बदल सकते हैं.
जगह के फ़ोटो अनुरोध
जगह की फ़ोटो का अनुरोध, इस फ़ॉर्म का एचटीटीपी यूआरएल होता है:
https://maps.googleapis.com/maps/api/place/photo?parameters
खोज अनुरोध करने के लिए, कुछ पैरामीटर ज़रूरी हैं. जैसा कि यूआरएल में
स्टैंडर्ड होता है, सभी पैरामीटर को एंपरसैंड (&
) वर्ण का इस्तेमाल करके अलग किया जाता है. पैरामीटर की सूची और उनकी संभावित वैल्यू नीचे दी गई हैं.
Required parameters
photo_reference
A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.
Optional parameters
maxheight
Specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio. Both the
maxheight
andmaxwidth
properties accept an integer between1
and1600
.maxwidth
Specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio. Both the
maxheight
andmaxwidth
properties accept an integer between1
and1600
.
Generated from the OpenAPI specification. Edit Report bug
फ़ोटो रेफ़रंस
जगह की फ़ोटो सेवा के लिए किए जाने वाले सभी अनुरोधों में, photoreference
जगह की जानकारी ढूंढना, आस-पास के इलाकों में खोज करना, टेक्स्ट सर्च करना या जगह की जानकारी का अनुरोध करना शामिल होना चाहिए. अगर जगह से जुड़ी फ़ोटोग्राफ़िक सामग्री है, तो इन अनुरोधों के जवाब में photos[]
फ़ील्ड होगा.
ध्यान दें: दिखाई गई फ़ोटो की संख्या, अनुरोध के हिसाब से अलग-अलग हो सकती है.
- किसी जगह को ढूंढने, आस-पास के नतीजे दिखाने वाली खोज या टेक्स्ट सर्च का अनुरोध करने पर
इंडेक्स में ज़्यादा से ज़्यादा एक
photo
एलिमेंट मिलता है. - जगह की जानकारी के अनुरोध में ज़्यादा से ज़्यादा दस
photo
एलिमेंट दिखते हैं.
हर photo
एलिमेंट में ये फ़ील्ड होंगे:
photo_reference
— फ़ोटो का अनुरोध करने पर फ़ोटो की पहचान करने वाली स्ट्रिंग.height
— इमेज की ज़्यादा से ज़्यादा ऊंचाई.width
— इमेज की ज़्यादा से ज़्यादा चौड़ाई.html_attributions[]
— में सभी ज़रूरी एट्रिब्यूशन शामिल हैं. यह फ़ील्ड हमेशा मौजूद रहेगा, लेकिन यह खाली हो सकता है.
फ़ोटो सेवा की ओर से लौटाए जाने वाले फ़ोटो कई स्थानों से लिए जाते हैं, जिनमें कारोबार के मालिक और उपयोगकर्ता की ओर से दी गई फ़ोटो शामिल होती हैं. ज़्यादातर मामलों में,
इन फ़ोटो का इस्तेमाल बिना एट्रिब्यूशन के किया जा सकता है या इमेज के हिस्से के तौर पर ज़रूरी एट्रिब्यूशन शामिल किया जा सकता है. हालांकि, अगर दिखाए गए photo
एलिमेंट में html_attributions
फ़ील्ड की कोई वैल्यू शामिल है, तो आपको जहां भी इमेज दिखानी होगी वहां आपको अपने ऐप्लिकेशन में अतिरिक्त एट्रिब्यूशन शामिल करना होगा.
photos[]
कैटगरी का एक उदाहरण नीचे दिया गया है.
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
}
...
जगह की फ़ोटो का उदाहरण
अनुरोध का एक उदाहरण नीचे दिखाया गया है. यह अनुरोध ज़्यादा से ज़्यादा 400 पिक्सल चौड़ा होने की वजह से, बताई गई इमेज वापस कर देगा.
https://maps.googleapis.com/maps/api/place/photo ?maxwidth=400 &photo_reference=Aap_uEA7vb0DDYVJWEaX3O-AtYp77AaswQKSGtDaimt3gt7QCNpdjp1BkdM6acJ96xTec3tsV_ZJNL_JP-lqsVxydG3nh739RE_hepOOL05tfJh2_ranjMadb3VoBYFvF0ma6S24qZ6QJUuV6sSRrhCskSBP5C1myCzsebztMfGvm7ij3gZT &key=YOUR_API_KEY
जगह की फ़ोटो का जवाब
प्लेस फ़ोटो के सफल अनुरोध के जवाब में एक इमेज होगी. इमेज का टाइप, Google को सबमिट की गई फ़ोटो के टाइप के हिसाब से तय होगा.
अगर आपका अनुरोध उपलब्ध कोटा से ज़्यादा हो जाता है, तो सर्वर एक एचटीटीपी 403 स्थिति दिखाएगा और यह बताने के लिए नीचे को इमेज दिखाएगा कि कोटा पार हो गया है:
अगर सर्वर आपके अनुरोध को समझ नहीं पा रहा है, तो यह एचटीटीपी 400 स्थिति दिखाता है जो अमान्य अनुरोध दिखाता है. अमान्य अनुरोध की सबसे सामान्य वजहों में ये शामिल हैं:
- सबमिट किया गया फ़ोटो संदर्भ सही तरीके से बताया नहीं गया था.
- अनुरोध में
maxwidth
याmaxheight
पैरामीटर शामिल नहीं थे. maxwidth
याmaxheight
पैरामीटर की वैल्यू,null
पर सेट की गई.