تتيح Places API استخدام العنصر الحالي صورة المكان. إذا كنت على دراية بالميزات الحالية في "صورة المكان"، يُجري الإصدار الجديد من "صورة المكان" التغييرات التالية:
- تتطلّب خدمة "صور الأماكن" الجديدة أن يتم ضبط اسم مورد الصورة الذي يتضمّن رقم تعريف المكان في عنوان URL للطلب، بدلاً من مرجع الصورة فقط. لمزيد من المعلومات، يُرجى مراجعة التغيير إلى مراجع الصور:
- تتوافق خدمة "صور الأماكن" الجديدة مع كلاً من مفاتيح واجهة برمجة التطبيقات ورموز OAuth كميكانيزمات للمصادقة.
يسرد الجدول التالي المَعلمات في "صورة المكان" الحالية التي تمت إعادة تسميتها أو تعديلها في "صورة المكان" الجديدة، أو المَعلمات التي لم تعُد متوافقة.
| المَعلمة الحالية | معلَمة جديدة | ملاحظات |
|---|---|---|
maxheight |
maxHeightPx |
يجب تحديد maxHeightPx أو
maxWidthPx أو كليهما. |
maxwidth |
maxWidthPx |
يجب تحديد إما maxHeightPx،
maxWidthPx أو كليهما. |
زيادة حجم الصورة
تم دعم الحد الأقصى لصورة في صورة المكان الحالية بحجم 1600 × 1600 بكسل. صورة مكان (جديدة) ويتوافق مع أحجام تصل إلى 4800 × 4800 بكسل.
التغيير إلى مراجع الصور
صورة المكان تتطلب واجهة برمجة التطبيقات أن يتم ضبط اسم المورد للصورة المطلوبة، والذي يكون يتضمّن رقم تعريف مكان ومرجع الصورة، في النموذج:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
تعرض الإصدارات الجديدة من "البحث في الأماكن القريبة" و"البحث النصي" و"تفاصيل الأماكن" صفيفًا من النوع photos[] في الاستجابة التي تتيح هذا التنسيق. على كل
العنصر photos[] في الرد الجديد يحتوي على الحقول التالية:
name— سلسلة تحتوي على اسم مورد صورة. تكون هذه السلسلة بالشكل التالي:places/PLACE_ID/photos/PHOTO_REFERENCE
-
heightPx: الحد الأقصى لارتفاع الصورة، بالبكسل widthPx— الحد الأقصى لعرض الصورة بالبكسل.authorAttributions[]— أي سمات مطلوبة هذا النمط يكون الحقل موجودًا دائمًا، ولكنه قد يكون فارغًا.
باستخدام واجهة برمجة التطبيقات الحالية، عليك فقط تمرير مرجع الصورة، في النموذج:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
تتيح لك علامة التبويب "العثور على المكان" الحالية
"البحث عن قرب" و"البحث النصي"
تعرض جميع تفاصيل المكان مصفوفة photos[] في
رد يدعم هذا التنسيق. كل عنصر photo في العنصر الحالي
يحتوي الرد على الحقول التالية:
-
photo_reference: سلسلة تُستخدَم لتحديد الصورة عند تنفيذ طلب للحصول على صورة. height- الحد الأقصى لارتفاع الصورة.-
width: الحد الأقصى لعرض الصورة html_attributions[]— أي سمات مطلوبة يكون هذا الحقل متاحًا دائمًا، ولكن قد يكون فارغًا.