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

أماكن API هي خدمة تعرض معلومات حول الأماكن باستخدام طلبات HTTP. عادةً ما يتم تحديد الأماكن هنا ضمن واجهة برمجة التطبيقات هذه على أنها مؤسسات أو مواقع جغرافية أو نقاط اهتمام بارزة.

هناك خمسة أنواع من الطلبات المتاحة داخل واجهة برمجة التطبيقات. هم انهم:

  • وضع البحث الذي يعرض قائمة بالأماكن بناءً على موقع المستخدم أو سلسلة البحث.
  • تفاصيل المكان التي تقدم معلومات مفصلة حول مكان معين ، مع تعليقات المستخدمين المدرجة.
  • تمنح صور المكان إمكانية الوصول إلى ملايين الصور المتعلقة بالمكان المحفوظة في قاعدة بيانات مكان Google.
  • مكان الإكمال التلقائي موجود لملء اسم أو عنوان مكان تلقائيًا أثناء كتابة المستخدمين.
  • يوفر الإكمال التلقائي للاستعلام خدمة التنبؤ بالاستعلام لعمليات البحث الجغرافية المستندة إلى النصوص ، ويعيد الاستعلامات المقترحة أثناء قيام المستخدمين بكتابتها.

للعمل مع واجهة برمجة تطبيقات الأماكن ، تحتاج إلى مفتاح يجب تضمينه في كل طلب من طلبات واجهة برمجة تطبيقات الأماكن. دعنا نتعرف على ما هو بالضبط وكيفية الحصول على مفتاح API لواجهة برمجة تطبيقات أماكن Google.

اقرأ أيضاً :  كيفية الحصول على مفتاح Etsy API واستخدامه

كيفية إنشاء مفتاح 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 الجديد مدرج في صفحة بيانات الاعتماد ضمن قسم مفاتيح واجهة برمجة التطبيقات.
نصيحة : يجب أن يكون لديك مفتاح 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 الخاص بك.

اقرأ أيضاً :  كيفية تغيير تنسيق النص إلى تاريخ في Excel؟ - صيغ مفيدة

كيفية تقييد مفتاح API الخاص بك في أماكن Google

هناك نوعان من القيود وعليك إعداد كليهما. هم انهم:

  • تقييد التطبيق . تتيح لك هذه الميزة قصر استخدام مفتاح API على مواقع الويب أو خوادم الويب أو تطبيقات الأجهزة المحمولة. هناك قيد واحد فقط من هذه الفئة يمكن اختياره.
  • تقييد API . يحد هذا النوع من التقييد من استخدام مفتاح واجهة برمجة التطبيقات بواحدة أو أكثر من واجهات برمجة التطبيقات أو حزم تطوير البرامج.
نصيحة : تذكر أن واجهة برمجة تطبيقات الأماكن لا تعمل مع مفتاح واجهة برمجة تطبيقات مقيد لنظام التشغيل Android أو iOS.

بعد تعيين القيود ، كل ما تبقى هو النقر على زر حفظ.

استخدام واجهة برمجة تطبيقات أماكن 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/queryautocomplete/json?key=YOUR_API_KEY&input=pizza+near%20par
نصيحة : من أجل جعل جميع الأمثلة المذكورة أعلاه تعمل من أجلك ، تحتاج إلى استبدال مفتاح API بالمفتاح الذي لديك.

أسعار وحدود واجهة برمجة تطبيقات أماكن 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 للعثور على مزيد من التفاصيل حول جميع الأسعار والحدود.

اترك تعليقاً

لن يتم نشر عنوان بريدك الإلكتروني. الحقول الإلزامية مشار إليها بـ *

error: Content is protected !!