Places Aggregate API هي خدمة تقدّم إحصاءات حول الأماكن ضمن منطقة محدّدة استنادًا إلى معايير مثل الموقع الجغرافي والنوع وحالة التشغيل ومستوى السعر وتقييمات المستخدمين. يمكن أن تساعد هذه الخدمة في تحليل كثافة أنواع الأماكن المحدّدة حول موقع جغرافي معيّن، والإجابة عن أسئلة مثل "ما هي المطاعم التي حصلت على تقييم 5 نجوم ورمز السعر $$$ ضمن دائرة نصف قطرها 5 كيلومترات من هذا الموقع الجغرافي؟" أو "كم عددها؟"
يتم عرض النتائج إما كأعداد مجمّعة أو كمعرّفات الأماكن المحدّدة في منطقة البحث محل الاهتمام. يمكن للمستخدمين استخدام Place Details API لاسترداد المزيد من المعلومات حول معرّفات الأماكن هذه.
أسباب استخدام Places Aggregate API
تتيح واجهة Places Aggregate API للمستخدمين اتّخاذ قرارات مستندة إلى البيانات استنادًا إلى المعلومات الشاملة التي تقدّمها حول أماكن مختلفة. وتستفيد من نماذج الأماكن الدقيقة والحديثة، ما يتيح حالات الاستخدام الرئيسية التالية:
- الأنشطة التجارية: تحليل المنافسة والمواقع الجغرافية المحتملة لفروع جديدة
- المطوّرون: يمكنك إنشاء تطبيقات تقدّم اقتراحات مخصّصة.
- الباحثون: يمكنهم فحص المؤشرات والأنماط في مجالات معيّنة.
الإجراءات التي تتيحها واجهة Places Aggregate API
باستخدام Places Aggregate API، يمكنك الحصول على المعلومات التالية:
- الأعداد: استرداد عدد الأماكن التي تطابق معاييرك
- أرقام تعريف الأماكن: يمكنك استرداد أرقام تعريف الأماكن الخاصة بأماكن محدّدة تتطابق مع معاييرك.
يمكنك أيضًا استخدام الفلترة لتحسين نتائج البحث استنادًا إلى سمات مختلفة، مثل أنواع الأماكن وساعات العمل ومستويات الأسعار وتقييمات العملاء.
أمثلة
يوضّح هذا القسم أمثلة على حالات استخدام Places Aggregate API ويتضمّن رمزًا برمجيًا صالحًا لكل مثال.
افتتاح مقهى جديد
يريد صاحب مطعم فتح مقهى جديد. ولتحقيق ذلك، يريدون أولاً تصوّر الأماكن التي تتوفّر فيها المقاهي بكثرة، كي يتمكّنوا من تحديد المناطق التي تتوفّر فيها المقاهي بكثافة عالية أو منخفضة، ما يساعدهم في اتّخاذ قرارات بشأن نشاطهم التجاري. يمكن أن تساعد واجهة Places Aggregate API في تحليل عدد المقاهي ضمن نطاق جغرافي محدّد استنادًا إلى سمات مثل حالة العمل ومستويات الأسعار وتقييمات العملاء لاتّخاذ قرار مستند إلى البيانات بشأن مكان افتتاح الفرع التالي.
شركة استثمار عقاري
تريد شركة استثمار عقاري تحسين نماذجها المالية وتحديد عائد الاستثمار بدقة في استثماراتها العقارية المخطط لها. باستخدام Places Aggregate API، يمكنهم جمع بيانات تفصيلية عن وسائل الراحة القريبة من العقارات الاستثمارية المحتملة، مثل ماكينات الصرّاف الآلي والمستشفيات ومحطات النقل العام ومتاجر البقالة، حتى يتمكّنوا من فهم وسائل الراحة القريبة من العقارات الاستثمارية المحتملة.
خدمة توصيل منتجات البيع بالتجزئة
عند التوسّع إلى مدينة جديدة، تحتاج خدمة توصيل البيع بالتجزئة إلى تحديد عدد سائقي التوصيل الذين سيتم تخصيصهم لمنطقة معيّنة استنادًا إلى كثافة الوجهات الاستهلاكية الشائعة، مثل المطاعم والمتاجر الصغيرة ومتاجر المشروبات الكحولية. باستخدام واجهة برمجة التطبيقات، تحسب خدمة التوصيل إجمالي عدد هذه المؤسسات في جميع أنحاء المدينة حتى تتمكّن من التخطيط للموارد وتخصيصها بفعالية.
طريقة عمل Places Aggregate API
تتيح لك Places Aggregate API تحديد فلاتر لتضييق نطاق معايير البحث.
بعد اختيار نوع إحصاء من INSIGHT_COUNT أو INSIGHT_PLACES، يمكنك إضافة معايير الفلتر، بما في ذلك ما يلي:
- الموقع الجغرافي: حدِّد منطقة الاهتمام باستخدام الدوائر أو المناطق أو المضلّعات المخصّصة.
- النوع: حدِّد أنواع الأماكن التي تهمّك.
- حالة العمليات: فلترة الأماكن استنادًا إلى حالة عملياتها
- مستويات الأسعار: لفلترة الأماكن استنادًا إلى مستويات الأسعار
- التقييمات: لفلترة الأماكن استنادًا إلى تقييمات المستخدمين
يحتوي عنصر ComputeInsightsResponse في الردّ من واجهة برمجة التطبيقات على نتائج الإحصاءات المطلوبة. على سبيل المثال، إذا اخترت INSIGHT_COUNT، ستحتوي الاستجابة على إجمالي عدد الأماكن، وإذا اخترت INSIGHT_PLACES، ستحتوي الاستجابة على قائمة بمعرّفات الأماكن.
كيفية استخدام Places Aggregate API
| 1 | إعداد الميزة: | ابدأ بإعداد مشروعك على Google Cloud واتّبِع التعليمات التي تظهر بعد ذلك. |
| 2 | قدِّم طلبًا للحصول على عدد الأماكن المطابقة. | اطّلِع على مقالة تقديم طلبك الأول. |
| 3 | مزيد من المعلومات عن مَعلمات الطلب | يُرجى الاطّلاع على مَعلمات الطلب. |
الخطوات التالية
- مراجعة الأسعار وحدود الاستخدام
- عرض مرجع واجهة برمجة التطبيقات
- مراجعة الأسئلة الشائعة
- الاطّلاع على خيارات الدعم