تتيح 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[]— أي سمات مطلوبة هذا النمط يكون الحقل موجودًا دائمًا، ولكنه قد يكون فارغًا.