نقل البيانات إلى ميزة "صور الأماكن" (ميزة جديدة)

مقدمة

تتيح واجهة Places API استخدام Place Photos (القديمة). إذا كنت على دراية بواجهة برمجة التطبيقات Place Photos (القديمة)، تُجري واجهة برمجة التطبيقات Place Photos (الجديدة) التغييرات التالية:

• تتطلّب واجهة برمجة التطبيقات Place Photos (New) تمرير اسم مورد الصورة، والذي يتضمّن رقم تعريف المكان في عنوان URL للطلب، بدلاً من مرجع الصورة فقط. لمزيد من المعلومات، يُرجى الاطّلاع على التغيير في مراجع الصور.
• تتيح خدمة Place Photos (الجديدة) استخدام كلّ من مفاتيح واجهة برمجة التطبيقات ورموز OAuth المميّزة كآلية مصادقة.

يعرض الجدول التالي المَعلمات في Place Photos (الإصدار القديم) التي تمت إعادة تسميتها أو تعديلها في Place Photos (الإصدار الجديد)، أو المَعلمات التي لم تعد متاحة.

المَعلمة الحالية	معلَمة جديدة	ملاحظات
maxheight	maxHeightPx	يجب تحديد السمة maxHeightPx أو maxWidthPx أو كلتيهما.
maxwidth	maxWidthPx	يجب تحديد السمة maxHeightPx أو maxWidthPx أو كلتيهما.

حجم أكبر للصور

كانت واجهة برمجة التطبيقات Place Photos (القديمة) تتيح استخدام صور بحجم أقصى يبلغ 1600 × 1600 بكسل. تتيح واجهة برمجة التطبيقات Place Photos (New) استخدام أحجام تصل إلى 4800 × 4800 بكسل.

التغيير إلى مراجع الصور

تتطلّب واجهة برمجة التطبيقات Place Photos (New) تمرير اسم المورد للصورة المطلوبة، والذي يتضمّن رقم تعريف المكان ومرجع الصورة، بالشكل التالي:

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

تعرض كل من واجهات برمجة التطبيقات بحث في الجوار (New) وText Search (New) وتفاصيل المكان (New) مصفوفة 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[]: أي معلومات مطلوبة عن المساهمين في العمل يكون هذا الحقل متوفّرًا دائمًا، ولكن قد يكون فارغًا.