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

المطوّرون في المنطقة الاقتصادية الأوروبية

مقدمة

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

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

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

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

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

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

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

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

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

تعرض كلّ من Nearby Search (الجديدة) وText Search (الجديدة) وPlace Details (الجديدة) مصفوفة 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

تعرض كلّ من Find Place (الإصدار القديم) وNearby Search (الإصدار القديم) وText Search (الإصدار القديم) وPlace Details (الإصدار القديم) مصفوفة photos[] في الردّ تتوافق مع هذا التنسيق. يحتوي كل عنصر photo في الرد القديم على الحقول التالية:

  • ‫photo_reference: سلسلة تُستخدَم لتحديد الصورة عند تنفيذ طلب صورة.
  • height: الحد الأقصى لارتفاع الصورة
  • width: الحد الأقصى لعرض الصورة
  • html_attributions[]: أي إشارات مطلوبة إلى المصدر هذا الحقل متوفّر دائمًا، ولكن قد يكون فارغًا.