رموز الأماكن

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

يتم تعريف كل رمز من خلال حقلَي استجابة:

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

مثال

توضّح الأمثلة التالية كيفية طلب معرّف الموارد المنتظم للرمز ولون الخلفية لواجهتَي برمجة التطبيقات Places API (الجديدة) وPlaces API. يُرجى العلم أنّ الطلب والردود مختلفان في هذين الإصدارَين من واجهة برمجة التطبيقات.

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"
      }
    }
  ]
}

    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

    {
      "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"
    }
          

    <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)
مستشفى	الشرطة