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

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

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

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

طلب "صور الأماكن" (الإصدار القديم) هو عنوان 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، ما يشير إلى أنّ الطلب غير صالح. تشمل الأسباب الأكثر شيوعًا لعدم صلاحية الطلب ما يلي: