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

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

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

طلبات 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[]: يحتوي على أي معلومات مطلوبة عن المصدر. سيكون هذا الحقل موجودًا دائمًا، ولكن قد يكون فارغًا.

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

مثال على Place Photos (الإصدار القديم)

في ما يلي مثال على الطلب. يعرض هذا الطلب الصورة المُشار إليها، مع تغيير حجمها بحيث لا يزيد عرضها عن 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 التي تشير إلى أنّ الطلب غير صالح. تشمل الأسباب الأكثر شيوعًا للطلب غير الصالح ما يلي: