صور المكان

اختيار نظام أساسي: Android iOS JavaScript خدمة الويب

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

تقديم طلبات الصور

طلب صورة المكان هو عنوان 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.

Optional parameters

  • 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. Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

  • 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.

Generated from the OpenAPI specification. Edit Report bug

مراجع الصور

يجب أن تشتمل جميع الطلبات إلى خدمة صور المكان على photoreference، والتي يتم عرضها في الرد على طلب العثور على مكان، أو البحث عن مكان قريب، أو البحث عن نص، أو تفاصيل المكان. ستتضمّن الاستجابة لهذه الطلبات الحقل photos[] إذا كان للمكان محتوى مصوَّر ذي صلة.

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

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

سيتضمن كل عنصر photo الحقول التالية:

  • photo_reference — سلسلة تستخدم لتحديد الصورة عند إجراء طلب صورة.
  • height — أقصى ارتفاع للصورة.
  • width — أقصى عرض للصورة.
  • html_attributions[] - يحتوي على أي إحالات مطلوبة. سيكون هذا الحقل موجودًا دائمًا، ولكنه قد يكون فارغًا.

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

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

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
   }
...

مثال لصورة المكان

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

https://maps.googleapis.com/maps/api/place/photo
  ?maxwidth=400
  &photo_reference=Aap_uEA7vb0DDYVJWEaX3O-AtYp77AaswQKSGtDaimt3gt7QCNpdjp1BkdM6acJ96xTec3tsV_ZJNL_JP-lqsVxydG3nh739RE_hepOOL05tfJh2_ranjMadb3VoBYFvF0ma6S24qZ6QJUuV6sSRrhCskSBP5C1myCzsebztMfGvm7ij3gZT
  &key=YOUR_API_KEY

الرد على وضع الصورة

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

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

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

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

  • لم يتم تحديد مرجع الصورة الذي تم إرساله بشكل صحيح.
  • لم يتضمن الطلب معلمات maxwidth أو maxheight.
  • تم ضبط قيمة المَعلمة maxwidth أو المَعلمة maxheight على null.