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

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

صور الأماكن (إصدار قديم)، وهو جزء من Places API، عبارة عن واجهة برمجة تطبيقات للقراءة فقط تتيح لك إضافة محتوى فوتوغرافي عالي الجودة إلى تطبيقك. تتيح لك ميزة "صور الأماكن" (الإصدار القديم) الوصول إلى ملايين الصور المخزّنة في قاعدة بيانات "الأماكن". عند الحصول على معلومات عن مكان باستخدام طلب Place Details، سيتم عرض مراجع للصور ذات الصلة بالمحتوى الفوتوغرافي. تعرض طلبات العثور على مكان (إصدار قديم) والبحث في الجوار (إصدار قديم) والبحث النصي (إصدار قديم) أيضًا مرجعًا واحدًا للصورة لكل مكان، عند الاقتضاء. باستخدام 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

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

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

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

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

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