تتيح Places API إضافة صورة المكان الحالية. إذا كنت على دراية بميزة "صورة المكان" الحالية، فإن الإصدار الجديد من صورة المكان سيجري التغييرات التالية:
- تتطلب خدمة "صور المكان" الجديدة تمرير اسم مورد الصورة، والذي يتضمن رقم تعريف المكان في عنوان URL للطلب، بدلاً من مرجع الصورة فقط. لمزيد من المعلومات، راجِع التغيير إلى مراجع الصور.
- تتيح خدمة "صور المكان" الجديدة استخدام كل من مفاتيح واجهة برمجة التطبيقات ورموز OAuth كآلية للمصادقة.
يسرد الجدول التالي المعلَمات في صورة المكان الحالية التي تمت إعادة تسميتها أو تعديلها لصورة المكان الجديدة، أو المعلمات التي لم تعد معتمدة.
| المعلمة الحالية | معلَمة جديدة | Notes |
|---|---|---|
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[]— أي سمات مطلوبة يكون هذا الحقل موجودًا دائمًا، ولكنه قد يكون فارغًا.