تتيح Places API استخدام ميزة Place Photo (صورة المكان) الحالية. إذا كنت على دراية بصورة المكان الحالية، فإن الإصدار الجديد من صورة المكان يُجري التغييرات التالية:
- تتطلّب خدمة "صورة المكان" الجديدة إدخال اسم مورد الصورة، الذي يتضمّن معرّف المكان في عنوان URL للطلب، بدلاً من مرجع الصورة فقط. لمزيد من المعلومات، يُرجى الاطّلاع على التغيير إلى مراجع الصور.
- تتيح خدمة Place Photo الجديدة استخدام كل من مفاتيح واجهة برمجة التطبيقات والرموز المميّزة لـ OAuth كآلية للمصادقة.
يسرد الجدول التالي المعلَمات في صورة المكان الحالية التي تمت إعادة تسميتها أو تعديلها لميزة "صورة المكان" الجديدة، أو المعلَمات التي لم تعد متوافقة.
| المَعلمة الحالية | معلَمة جديدة | Notes |
|---|---|---|
maxheight |
maxHeightPx |
يجب تحديد maxHeightPx أو maxWidthPx أو كليهما. |
maxwidth |
maxWidthPx |
يجب تحديد maxHeightPx أو maxWidthPx أو كليهما. |
زيادة حجم الصورة
كانت صورة المكان الحالية تدعم حدًا أقصى لحجم الصورة يبلغ 1600 × 1600 بكسل. صورة المكان (جديدة) تتيح استخدام أحجام تصل إلى 4800 × 4800 بكسل.
التغيير إلى مراجع الصور
تتطلّب واجهة برمجة التطبيقات Place Photo الجديدة منك إدخال اسم المورد للصورة المطلوبة، والذي يتضمن رقم تعريف المكان ومرجع الصورة، في النموذج:
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[]- أي عمليات إحالة مطلوبة هذا الحقل موجود دائمًا، ولكنه قد يكون فارغًا.