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

مقدمة

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

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

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

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

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

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