رموز الأماكن

اختيار النظام الأساسي: نظام التشغيل Android iOS JavaScript خدمة ويب

تشير أيقونات الأماكن إلى الأنواع المختلفة من الأماكن (على سبيل المثال، المقاهي، والمكتبات والمتاحف). يمكنك طلب عناوين URL للرموز بتنسيق PNG أو SVG، بالإضافة إلى لون خلفية الرمز المقابل، يتيح لك خيار "العثور على مكان" تفاصيل الأماكن والبحث عن الأماكن القريبة وطلبات البحث النصي. يمكن استخدام الأيقونات مضمّنة.

يتم تحديد كل رمز من خلال حقلين من حقول الرد:

  • يشتمل معرّف الموارد المنتظم (URI) لقاعدة الرموز على عنوان URL الأساسي للمعرّف غير الملوّن بدون امتداد نوع الملف. يجب إلحاق .svg أو .png إلى معرّف الموارد المنتظم (URI) لطلب الرمز.
  • يحتوي لون خلفية الرمز على رمز اللون السداسي العشري التلقائي فئة المكان.

مثال

توضح الأمثلة التالية كيفية طلب عنوان URI للرمز ولون الخلفية من أجل 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"
      }
    }
  ]
}

واجهة برمجة تطبيقات الأماكن

يوضح المثال التالي طلب العثور على مكان الذي يتضمّن 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) بالرمز المعروض عنوان 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)

مستشفى مستشفى

شرطة شرطة