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