أماكن API هي خدمة تعرض معلومات حول الأماكن باستخدام طلبات HTTP. عادةً ما يتم تحديد الأماكن هنا ضمن واجهة برمجة التطبيقات هذه على أنها مؤسسات أو مواقع جغرافية أو نقاط اهتمام بارزة.
هناك خمسة أنواع من الطلبات المتاحة داخل واجهة برمجة التطبيقات. هم انهم:
- وضع البحث الذي يعرض قائمة بالأماكن بناءً على موقع المستخدم أو سلسلة البحث.
- تفاصيل المكان التي تقدم معلومات مفصلة حول مكان معين ، مع تعليقات المستخدمين المدرجة.
- تمنح صور المكان إمكانية الوصول إلى ملايين الصور المتعلقة بالمكان المحفوظة في قاعدة بيانات مكان Google.
- مكان الإكمال التلقائي موجود لملء اسم أو عنوان مكان تلقائيًا أثناء كتابة المستخدمين.
- يوفر الإكمال التلقائي للاستعلام خدمة التنبؤ بالاستعلام لعمليات البحث الجغرافية المستندة إلى النصوص ، ويعيد الاستعلامات المقترحة أثناء قيام المستخدمين بكتابتها.
للعمل مع واجهة برمجة تطبيقات الأماكن ، تحتاج إلى مفتاح يجب تضمينه في كل طلب من طلبات واجهة برمجة تطبيقات الأماكن. دعنا نتعرف على ما هو بالضبط وكيفية الحصول على مفتاح API لواجهة برمجة تطبيقات أماكن Google.
كيفية إنشاء مفتاح API الخاص بأماكن Google
مفتاح API هو معرف فريد موجود لمصادقة الطلبات المرتبطة بمشروعك لأغراض الاستخدام والفوترة. باستخدام مفتاح API لمصادقة الطلبات ، يمكنك:
- إدارة واجهات برمجة التطبيقات الخاصة بك في Google Cloud Console.
- الوصول إلى بيانات الاستخدام في الوقت الفعلي و 30 يومًا من بيانات الاستخدام السابقة لمدة 30 يومًا في وحدة تحكم Google Cloud Platform.
- راقب تقارير الاستخدام مع أكثر من 30 يومًا من المعلومات في بوابة Google Cloud Support Portal.
يمكنك العثور على مزيد من المعلومات حول التقارير المتاحة لعملاء خطة Premium هنا . الآن يمكنك المتابعة للحصول على المفتاح.
احصل على مفتاح واجهة برمجة تطبيقات الأماكن وأضفه إلى طلبك
للحصول على مفتاح API الخاص بك ، تحتاج إلى تنفيذ الإجراءات التالية:
- افتح Google Cloud Platform Console.
- انقر فوق القائمة المنسدلة للمشروع واختر المشروع الذي تم إنشاؤه لك. يجب أن يبدأ اسمها بـ Google Maps APIs for Business أو Google Maps for Work أو Google Maps.
- ثم انقر فوق زر القائمة واختر واجهات برمجة التطبيقات والخدمات> بيانات الاعتماد.
- في صفحة بيانات الاعتماد ، اختر إنشاء بيانات اعتماد> مفتاح API. هناك سترى مربع حوار تم إنشاؤه لمفتاح API يوضح المفتاح الذي تم إنشاؤه حديثًا.
- أغلق علامة التبويب. مفتاح API الجديد مدرج في صفحة بيانات الاعتماد ضمن قسم مفاتيح واجهة برمجة التطبيقات.
ثم يتعين عليك إضافة مفتاح واجهة برمجة التطبيقات إلى كل طلب من طلبات واجهة برمجة تطبيقات الأماكن. باستخدام المثال التالي ، ما عليك سوى استبدال YOUR_API_KEY بمفتاح API الخاص بك:
|
1
2
3
4
5
6
|
https://maps.googleapis.com/maps/api/place/nearbysearch/json ?location=-33.8670522,151.1957362 &radius=500 &types=food &name=harbour &key=YOUR_API_KEY |
ضع في اعتبارك أن Google توصي بشدة بتقييد مفتاح API الخاص بك. تمنح القيود أمانًا إضافيًا وتساعد على ضمان إجراء الطلبات المصرح بها فقط باستخدام مفتاح API الخاص بك.
كيفية تقييد مفتاح API الخاص بك في أماكن Google
هناك نوعان من القيود وعليك إعداد كليهما. هم انهم:
- تقييد التطبيق . تتيح لك هذه الميزة قصر استخدام مفتاح API على مواقع الويب أو خوادم الويب أو تطبيقات الأجهزة المحمولة. هناك قيد واحد فقط من هذه الفئة يمكن اختياره.
- تقييد API . يحد هذا النوع من التقييد من استخدام مفتاح واجهة برمجة التطبيقات بواحدة أو أكثر من واجهات برمجة التطبيقات أو حزم تطوير البرامج.
بعد تعيين القيود ، كل ما تبقى هو النقر على زر حفظ.
استخدام واجهة برمجة تطبيقات أماكن Google: أمثلة
هناك عدة طرق لاستخدام واجهة برمجة تطبيقات أماكن Google. دعنا نرى بعض منهم.
مكان البحث
كما ذكر أعلاه ، تتيح لك الأماكن API البحث عن معلومات المكان باستخدام عدد كبير من الفئات. يوضح المثال التالي لواجهة برمجة تطبيقات أماكن Google طلب البحث عن مكان لـ “متحف الفن المعاصر أستراليا”:
|
1
|
https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=photos,formatted_address,name,rating,opening_hours,geometry&key=YOUR_API_KEY |
تفاصيل المكان
بمجرد الحصول على place_id من بحث أماكن Google ، يمكنك الحصول على مزيد من المعلومات حول مؤسسة معينة أو نقطة اهتمام عن طريق بدء طلب تفاصيل المكان. هنا يمكننا مشاهدة طلب تفاصيل مكان عن طريق place_id:
|
1
|
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name,rating,formatted_phone_number&key=YOUR_API_KEY |
صور المكان
تتيح لك هذه الخدمة إضافة محتوى الصورة إلى تطبيقاتك ، كما تتيح الوصول إلى ملايين الصور المخزنة في قاعدة بيانات الأماكن. إليك مثال لطلب:
|
1
|
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY |
ضع الإكمال التلقائي
إنها خدمة ويب تعرض تنبؤات المكان كاستجابة لطلب HTTP. يمكن استخدامه لتوفير وظيفة الإكمال التلقائي لعمليات البحث الجغرافية القائمة على النص. فيما يلي مثال لطلب المؤسسات:
|
1
|
https://maps.googleapis.com/maps/api/place/autocomplete/xml?input=Amoeba&types=establishment&location=37.76999,-122.44696&radius=500&key=YOUR_API_KEY |
الاستعلام عن الإكمال التلقائي
يتم استخدام هذا النوع من الخدمة لتوفير توقع استعلام لعمليات البحث الجغرافية المستندة إلى النص ، من خلال إعادة الاستعلامات المقترحة كأنواع المستخدم. يبدو طلب المثال كالتالي:
|
1
|
https://maps.googleapis.com/maps/api/place/queryautocomplete/json?key=YOUR_API_KEY&input=pizza+near%20par |
أسعار وحدود واجهة برمجة تطبيقات أماكن Google
هنا تستخدم Google نموذج تسعير الدفع أولاً بأول. هذا يعني أن واجهات برمجة تطبيقات Google Maps Platform يتم تحصيلها من قِبل SKU. يتم تتبع الاستخدام لكل منتج SKU ، وقد تحتوي واجهة برمجة التطبيقات (API) على أكثر من منتج SKU.
هناك 1000 عملية بحث مجانية لواجهة برمجة تطبيقات الأماكن لكل 24 ساعة ، ولكن يمكنك زيادتها إلى 150000 عملية بحث مجانية لمدة 24 ساعة عن طريق تمكين الفوترة في Google Cloud Console.
| نطاق الحجم الشهري (السعر لكل مكالمة) | 0-100000 | 100،001 – 500،000 | 500000+ | |
| الإكمال التلقائي | 0.00283 دولار أمريكي لكل واحد (2.83 دولار أمريكي لكل 1000) | 0.00227 دولار أمريكي لكل منها (2.27 دولار أمريكي لكل 1000) | الاتصال بالمبيعات لتسعير الحجم | |
| الاستعلام عن الإكمال التلقائي | 0.00283 دولار أمريكي لكل واحد (2.83 دولار أمريكي لكل 1000) | 0.00227 دولار أمريكي لكل منها (2.27 دولار أمريكي لكل 1000) | الاتصال بالمبيعات لتسعير الحجم | |
| تفاصيل الأماكن | 0.017 دولارًا أمريكيًا لكل منها (17.00 دولارًا أمريكيًا لكل 1000) | 0.0136 دولارًا أمريكيًا لكل منها (13.60 دولارًا أمريكيًا لكل 1000 دولار أمريكي) | الاتصال بالمبيعات لتسعير الحجم | |
| صور الأماكن | 0.007 دولار أمريكي لكل واحد (7.00 دولار أمريكي لكل 1000) | 0.0056 دولارًا أمريكيًا لكل منها (5.60 دولارًا أمريكيًا لكل 1000 دولار أمريكي) | الاتصال بالمبيعات لتسعير الحجم | |
| يبحث | 0.032 دولارًا أمريكيًا لكل منها (32.00 دولارًا أمريكيًا لكل 1000) | 0.0256 دولار أمريكي لكل منها (25.60 دولار أمريكي لكل 1000) | الاتصال بالمبيعات لتسعير الحجم |
يمكنك التحقق من وثائق Google Place API للعثور على مزيد من التفاصيل حول جميع الأسعار والحدود.