تشير أيقونات الأماكن إلى الأنواع المختلفة من الأماكن (على سبيل المثال، المقاهي، والمكتبات والمتاحف). يمكنك طلب عناوين 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) |
|||
|
|