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