صور الأماكن (الإصدار القديم)

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

صور الأماكن (إصدار قديم)، وهو جزء من Places API، عبارة عن واجهة برمجة تطبيقات للقراءة فقط تتيح لك إضافة محتوى فوتوغرافي عالي الجودة إلى تطبيقك. تتيح لك ميزة "صور الأماكن" (الإصدار القديم) الوصول إلى ملايين الصور المخزّنة في قاعدة بيانات "الأماكن". عند الحصول على معلومات عن مكان باستخدام طلب "تفاصيل المكان"، سيتم عرض مراجع الصور للمحتوى الفوتوغرافي ذي الصلة. تعرض طلبات العثور على مكان (إصدار قديم) والبحث في الجوار (إصدار قديم) والبحث النصي (إصدار قديم) أيضًا مرجعًا واحدًا للصورة لكل مكان، عند الاقتضاء. باستخدام Place Photos (Legacy)، يمكنك الوصول إلى الصور المُشار إليها وتغيير حجم الصورة إلى الحجم الأمثل لتطبيقك.

طلبات "صور الأماكن" (الإصدار القديم)

طلب "صور الأماكن (الإصدار القديم)" هو عنوان URL يستخدم HTTP بالشكل التالي:

https://maps.googleapis.com/maps/api/place/photo?parameters

يجب توفّر مَعلمات معيّنة لبدء طلب بحث. وكما هو معتاد في عناوين URL، يتم الفصل بين جميع المَعلمات باستخدام رمز العطف (&). في ما يلي قائمة بالمعلمات وقيمها المحتملة.

المعلمات المطلوبة

  • photo_reference

    معرّف سلسلة يحدّد صورة بشكل فريد. يتم عرض مراجع الصور من خلال طلب "البحث عن الأماكن" أو "تفاصيل المكان".

  • maxheight أو maxwidth

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

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

    تقبل كل من السمتَين maxheight وmaxwidth عددًا صحيحًا يتراوح بين 1 و1600.

    يجب تحديد maxheight أو maxwidth أو كليهما.

مراجع الصور

يجب أن تتضمّن جميع الطلبات إلى صور الأماكن (الإصدار القديم) photo_reference، التي يتم عرضها في الردّ على طلب العثور على مكان (الإصدار القديم) أو بحث في الجوار (الإصدار القديم) أو البحث النصي (الإصدار القديم) أو تفاصيل المكان (الإصدار القديم). ستحتوي الاستجابة لهذه الطلبات على حقل photos[] إذا كان المكان يتضمّن محتوى فوتوغرافيًا ذا صلة.

ملاحظة: يختلف عدد الصور التي يتم عرضها حسب الطلب.

  • يعرض طلب العثور على مكان (الإصدار القديم) أو بحث في الجوار (الإصدار القديم) أو البحث النصي (الإصدار القديم) عنصر photo واحدًا على الأكثر في المصفوفة.
  • يعرض طلب "تفاصيل المكان (الإصدار القديم)" ما يصل إلى عشرة عناصر photo.

يحتوي كل عنصر photo على الحقول التالية:

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

يتم الحصول على الصور التي تعرضها خدمة صور الأماكن (الإصدار القديم) من مجموعة متنوعة من المصادر، بما في ذلك مالكو المؤسسات والصور التي يساهم بها المستخدمون. في معظم الحالات، يمكن استخدام هذه الصور بدون الإشارة إلى المصدر، أو سيتم تضمين الإشارة المطلوبة إلى المصدر كجزء من الصورة. ومع ذلك، إذا كان عنصر photo الذي تم إرجاعه يتضمّن قيمة في الحقل html_attributions، يجب تضمين المعلومات الإضافية عن مصدر الصورة في تطبيقك أينما تعرض الصورة.

.

يوضّح المثال التالي طلب "تفاصيل المكان (الإصدار القديم)":

curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"

في ما يلي مثال على مصفوفة photos[] في الردّ.

    ...
    "photos" : [
       {
          "html_attributions" : [],
          "height" : 853,
          "width" : 1280,
          "photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
       }]
    ...

مثال على "صور الأماكن" (الإصدار القديم)

يظهر أدناه مثال على الطلب. يعرض هذا الطلب الصورة المشار إليها، مع تغيير حجمها لكي لا يزيد عرضها عن 400 بكسل.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

ردّ "صور الأماكن" (الإصدار القديم)

تكون الاستجابة لطلب ناجح من Place Photos (القديمة) عبارة عن صورة. يعتمد نوع الصورة على نوع الصورة التي تم إرسالها في الأصل.

إذا تجاوز طلبك الحصة المتاحة، يعرض الخادم حالة HTTP 403 ويعرض الصورة أدناه للإشارة إلى أنّه تم تجاوز الحصة:

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

إذا لم يتمكّن الخادم من فهم طلبك، سيعرض حالة HTTP 400 التي تشير إلى طلب غير صالح. تشمل الأسباب الأكثر شيوعًا للطلب غير الصالح ما يلي: