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

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