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