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