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 | التعرّف على مَعلمات الطلب | راجِع مَعلمات الطلب. |
الخطوات التالية
- مراجعة الأسعار وحدود الاستخدام
- عرض مرجع واجهة برمجة التطبيقات
- مراجعة الأسئلة الشائعة
- مراجعة خيارات الدعم