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

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

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

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

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

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

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

Required parameters

  • photo_reference

    A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.

  • maxheight or maxwidth

    maxheight specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    maxwidth specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

    You must specify either maxheight, or maxwidth, or both.

مراجع الصور

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

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

  • يعرض طلب Find Place (الإصدار القديم) أو Nearby Search (الإصدار القديم) أو Text Search (الإصدار القديم) عنصر 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 (الإصدار القديم)

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

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

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

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