जगह की जानकारी देने वाले आइकॉन से अलग-अलग जगहों (जैसे कि कॉफ़ी शॉप, लाइब्रेरी, और संग्रहालय) को दिखाया जाता है. जगह ढूंढें, जगह की जानकारी, आस-पास खोज, और टेक्स्ट खोजने के अनुरोधों की मदद से, PNG या SVG फ़ॉर्मैट में मौजूद आइकॉन के लिए यूआरएल का अनुरोध किया जा सकता है. साथ ही, उनके आइकॉन के बैकग्राउंड के रंग का भी अनुरोध किया जा सकता है. आइकॉन का इस्तेमाल इनलाइन किया जा सकता है.
हर आइकॉन को दो रिस्पॉन्स फ़ील्ड से तय किया जाता है:
- आइकॉन के बेस यूआरआई में बिना रंग वाले आइकॉन का बेस यूआरएल शामिल होता है, जिसमें फ़ाइल टाइप एक्सटेंशन को शामिल नहीं किया जाता है. आइकॉन का अनुरोध करने के लिए, आपको यूआरआई में
.svg
या.png
जोड़ना होगा. - आइकॉन के बैकग्राउंड के रंग में, जगह की कैटगरी के लिए डिफ़ॉल्ट रूप से हेक्स कलर कोड होता है.
उदाहरण
नीचे दिए गए उदाहरणों में बताया गया है कि Places API (नया) और Places API के लिए, आइकॉन यूआरआई और बैकग्राउंड कलर के लिए अनुरोध कैसे करें. ध्यान दें कि एपीआई के दोनों वर्शन के लिए अनुरोध और रिस्पॉन्स अलग-अलग होते हैं.
Places API (नया)
इस उदाहरण में, जगह का डिसप्ले नेम दिखाने के लिए टेक्स्ट सर्च (नया) का इस्तेमाल किया गया है. साथ ही, इसमें iconMaskBaseUri
और iconBackgroundColor
रिस्पॉन्स फ़ील्ड भी दिखाए गए हैं:
curl -X POST -d '{ "textQuery" : "skog haus", "maxResultCount" : 1 }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.iconMaskBaseUri,places.iconBackgroundColor' \ 'https://places.googleapis.com/v1/places:searchText'
जवाब इस फ़ॉर्म में है:
{ "places": [ { "iconMaskBaseUri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet", "iconBackgroundColor": "#FF9E67", "displayName": { "text": "SKÖG Haus Coffee & Tea", "languageCode": "en" } } ] }
Places API
इस उदाहरण में,
जगह ढूंढें का अनुरोध दिखाया
गया है, जिसमें icon_mask_base_uri
और icon_background_color
फ़ील्ड शामिल हैं:
https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=skog%20haus&inputtype=textquery&fields=name,icon_mask_base_uri,icon_background_color&key=API_KEY
इस उदाहरण में दिखाया गया है कि जगह ढूंढने के किसी अनुरोध के जवाब में, icon_mask_base_uri
और
icon_background_color
फ़ील्ड किस तरह दिखते हैं.
JSON
{ "candidates" : [ { "icon_background_color" : "#FF9E67", "icon_mask_base_uri" : "https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet", "name" : "SKÖG Haus Coffee", } ], "status" : "OK" }
XML
<FindPlaceFromTextResponse> <candidates> <name>SKÖG Haus Coffee</name> <icon_background_color>#FF9E67</icon_background_color> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet</icon_mask_base_uri> </candidates> <status>OK</status> </FindPlaceFromTextResponse>
कोई आइकॉन दिखाने के लिए, बताए गए आइकॉन यूआरआई में अपनी पसंद का फ़ाइल टाइप एक्सटेंशन (.png या .svg) जोड़ें. इसके बाद, आइकॉन को वापस आए बैकग्राउंड के रंग के साथ जोड़ें. उदाहरण के लिए, किसी वेब पेज पर .svg आइकॉन दिखाने के लिए:
<style> .icons-food-drink { background-color: #FF9E67; width: 88px; height: 88px; padding: 5px; } </style> <img src="https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet.svg" alt="Cafe" class="icons-food-drink"/>
जगह का आइकॉन और बैकग्राउंड में रंग भरने के अनुरोध
नीचे टेबल में कैटगरी के हिसाब से सभी उपलब्ध जगह आइकॉन दिखाए गए हैं. ये डिस्प्ले डिफ़ॉल्ट रूप से एक काले ग्लिफ़ के साथ नज़र आते हैं. आइकॉन के बैकग्राउंड का रंग, जगह की कैटगरी के हिसाब से तय होता है.
जगह की कैटगरी: खाना-पीना (आइकॉन के बैकग्राउंड का रंग #FF9E67) |
|||
---|---|---|---|
बार, नाइट क्लब |
कैफ़े |
रेस्टोरेंट, बेकरी |
|
जगह की कैटगरी: रीटेल (आइकॉन के बैकग्राउंड का रंग #4B96F3) |
|||
किताबें, कपड़े, इलेक्ट्रॉनिक्स, गहने, जूते, शॉपिंग सेंटर/मॉल |
![]() किराने की दुकान |
किराने का सामान, सुपरमार्केट |
फ़ार्मेसी |
जगह की कैटगरी: सेवाएं (आइकॉन के बैकग्राउंड का रंग #909CE1) |
|||
एटीएम |
बैंक |
पेट्रोल |
ठहरने की जगह |
पोस्ट ऑफ़िस |
|||
जगह की कैटगरी: मनोरंजन (आइकॉन के बैकग्राउंड का रंग #13B5C7) |
|||
अक्वेरियम, पर्यटक |
गॉल्फ़ |
ऐतिहासिक |
फ़िल्म |
म्यूज़ियम |
थिएटर |
||
जगह की कैटगरी: परिवहन (आइकॉन के बैकग्राउंड का रंग #10BDFF) |
|||
हवाई अड्डा |
बस, राइडशेयर, टैक्सी |
ट्रेन/रेल |
|
जगह की कैटगरी: नगरपालिका/सामान्य/धार्मिक (आइकॉन के बैकग्राउंड का रंग #7B9EB0) |
|||
कब्रिस्तान |
जनहित में बनी इमारत |
लाइब्रेरी |
स्मारक |
पार्किंग |
स्कूल (प्राइमरी, सेकंडरी, यूनिवर्सिटी) |
पूजा (ईसाई) |
|
पूजा (हिंदू) |
पूजा (इस्लाम) |
पूजा (जैन) |
पूजा (यहूदी) |
पूजा (सिख) |
सामान्य कारोबार |
||
जगह की कैटगरी: आउटडोर (आइकॉन के बैकग्राउंड का रंग #4DB546) |
|||
बोटिंग |
कैंपिंग |
पार्क |
स्टेडियम |
चिड़ियाघर |
|||
जगह की कैटगरी: आपातकालीन (आइकॉन के बैकग्राउंड का रंग #F88181) |
|||
अस्पताल |
पुलिस |