نمادهای مکان انواع مختلف مکان ها را نشان می دهند (به عنوان مثال کافی شاپ ها، کتابخانه ها و موزه ها). با جستجوی مکان، جزئیات مکان، جستجوی نزدیک، و جستجوی متن میتوانید نشانیهای وب برای نمادها در قالب PNG یا SVG و همچنین رنگ پسزمینه نماد مربوطه را درخواست کنید. می توان از نمادها به صورت درون خطی استفاده کرد.
هر نماد با دو فیلد پاسخ تعریف می شود:
- URI پایه نماد حاوی URL پایه برای یک نماد غیر رنگی است، منهای پسوند نوع فایل. برای درخواست نماد، باید
.svg
یا.png
را به URI اضافه کنید. - رنگ پسزمینه نماد حاوی کد رنگ HEX پیشفرض برای دسته مکان است.
مثال
مثالهای زیر نحوه درخواست URI نماد و رنگ پسزمینه را برای Places API (جدید) و Places API نشان میدهند. توجه داشته باشید که درخواست و پاسخ ها برای دو نسخه 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
مثال زیر یک درخواست Find Place را نشان می دهد که شامل فیلدهای 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
در پاسخ درخواست Find Place ظاهر میشوند.
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.) را به نماد بازگشتی URI اضافه کنید و نماد را با رنگ پسزمینه برگشتی ترکیب کنید. به عنوان مثال، برای نمایش نماد .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) | |||
بیمارستان | پلیس |