نمادهای مکان

پلتفرم را انتخاب کنید: سرویس وب جاوا اسکریپت اندروید iOS

نمادهای مکان انواع مختلف مکان ها را نشان می دهند (به عنوان مثال کافی شاپ ها، کتابخانه ها و موزه ها). با جستجوی مکان، جزئیات مکان، جستجوی نزدیک، و جستجوی متن می‌توانید نشانی‌های وب برای نمادها در قالب 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)
بیمارستان
بیمارستان
پلیس
پلیس