رموز الأماكن

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

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

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

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

قد تتغيّر عناوين URL للرموز، لذا احرص دائمًا على استخدام عنوان URL الأساسي للرمز للبحث عن عنوان URL للرمز. تتيح Places API (الإصدار القديم) حقل الردّ icon. لا تستخدِم حقل icon، ولكن استخدِم icon_background_color و icon_mask_base_uri مع Places API (الإصدار القديم).

مثال

توضّح الأمثلة التالية كيفية طلب معرّف الموارد المنتظم للرمز ولون الخلفية لواجهتَي برمجة التطبيقات 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)
مستشفى	الشرطة