رموز الأماكن

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

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

يتم تحديد كل أيقونة من خلال حقلي استجابة:

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

مثال

توضح الأمثلة التالية كيفية طلب عنوان URI للرمز ولون خلفية لواجهة برمجة تطبيقات الأماكن (جديد) وواجهة برمجة تطبيقات الأماكن. لاحظ أن الطلب والاستجابات مختلفتين لإصداري واجهة برمجة التطبيقات.

‫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)
مقبرة
مقبرة
مبنى مدني
مبنى مدني
المكتبة
المكتبة
نصب تذكاري
نصب تذكاري
موقف سيارات
موقف سيارات
المدرسة (الابتدائية، الثانوية، الجامعة)
المؤسسة التعليمية (الابتدائية، الثانوية، الجامعة)
عبادة (مسيحية)
العبادة (المسيحيون)
العبادة (هندوس)
العبادة (الهند)
عبادة (الإسلام)
العبادة (الإسلام)
عبادة (Jain)
العبادة (Jain)
عبادة (يهودي)
العبادة (اليهود)
العبادة (السيخيون)
العبادة (السيخيون)
نشاط تجاري عام
نشاط تجاري عام
فئة المكان: في الهواء الطلق
(لون خلفية الرمز #4DB546)
ركوب القارب
ركوب القوارب
تخييم
تخييم
متنزّه
متنزّه
استاد
ملعب
حديقة حيوانات
حديقة حيوانات
فئة المكان: طوارئ
(لون خلفية الرمز #F88181)
مستشفى
المستشفى
شرطة
الشرطة