نقل إلى صورة المكان (جديد)

تتيح Places API استخدام صورة المكان الحالية. إذا كنت على دراية بالميزات الحالية في "صورة المكان"، يُجري الإصدار الجديد من "صورة المكان" التغييرات التالية:

  • تتطلّب خدمة "صور الأماكن" الجديدة أن يتم ضبط اسم مورد الصورة الذي يتضمّن معرّف المكان في عنوان URL للطلب، بدلاً من مرجع الصورة فقط. لمزيد من المعلومات، يُرجى الاطّلاع على التغيير إلى مراجع الصور.
  • تتوافق خدمة "صور الأماكن" الجديدة مع كلاً من مفاتيح واجهة برمجة التطبيقات ورموز OAuth كميكانيزمات للمصادقة.

يسرد الجدول التالي المَعلمات في "صورة المكان" الحالية التي تمت إعادة تسميتها أو تعديلها في "صورة المكان" الجديدة، أو المَعلمات التي لم تعُد متوافقة.

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

زيادة حجم الصورة

كانت "صورة المكان" الحالية تتيح استخدام صور بحجم 1600 × 1600 بكسل كحد أقصى. تتيح ميزة "صورة المكان" (الإصدار الجديد) استخدام أحجام تصل إلى 4800 × 4800 بكسل.

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

تتطلّب واجهة برمجة التطبيقات الجديدة Place Photo API إرسال اسم المورد للصورة المطلوبة، والذي يتضمّن معرّف المكان ومرجع الصورة، على النحو التالي:

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