صور المكان

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

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

طلبات صور الأماكن

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

مراجع الصور

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