نمادهای مکان

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

نمادهای مکان انواع مختلف مکان ها را نشان می دهند (به عنوان مثال کافی شاپ ها، کتابخانه ها و موزه ها). با جستجوی مکان، جزئیات مکان، جستجوی نزدیک، و جستجوی متن می‌توانید نشانی‌های وب برای نمادها در قالب PNG یا SVG و همچنین رنگ پس‌زمینه نماد مربوطه را درخواست کنید. می توان از نمادها به صورت درون خطی استفاده کرد.

هر نماد با دو فیلد پاسخ تعریف می شود:

• URI پایه نماد حاوی URL پایه برای یک نماد غیر رنگی است، منهای پسوند نوع فایل. برای درخواست نماد، باید .svg یا .png را به URI اضافه کنید.
• رنگ پس‌زمینه نماد حاوی کد رنگ HEX پیش‌فرض برای دسته مکان است.

آدرس‌های اینترنتی نمادها ممکن است تغییر کنند، بنابراین مطمئن شوید که همیشه از URI پایه نماد برای جستجوی URL برای یک نماد استفاده کنید. API Places موجود از قسمت پاسخ icon پشتیبانی می کند. از فیلد icon استفاده نکنید، بلکه از icon_background_color و icon_mask_base_uri با Places API موجود استفاده کنید.

مثال

مثال‌های زیر نحوه درخواست 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)
بیمارستان	پلیس