المتطلّبات الأساسية

قبل أن تتمكن من ترميز تطبيق العميل الأول، عليك تنفيذ بعض الخطوات، في حال لم تكملها بعد.

أنشئ حسابًا على Google

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

ننصحك أيضًا باستخدام حساب Google منفصل لأغراض الاختبار.

تجربة ميزة "التجوّل الافتراضي من Google"

تفترض هذه المستندات المتعلّقة بواجهة برمجة التطبيقات أنّك استخدمت "التجوّل الافتراضي من Google"، وأنّك على دراية بمفاهيم البرمجة على الويب وبتنسيقات بيانات الويب.

إذا لم يسبق لك استخدام Google Street View، يمكنك تجربة واجهة المستخدم قبل بدء الترميز.

إنشاء مشروع لعميلك

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

لبدء استخدام Google Street View Publish API، عليك أولاً استخدام أداة الإعداد التي تقدّم لك إرشادات خلال عملية إنشاء المشروع في وحدة التحكم في Google API وتفعيل واجهة برمجة التطبيقات.

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

تعرَّف على أساسيات REST

تتوفر طريقتان لاستدعاء واجهة برمجة التطبيقات:

إذا قررت عدم استخدام مكتبات العملاء، عليك فهم أساسيات REST.

‫REST هو نمط هندسة برامج يقدّم نهجًا متسقًا وملائمًا لطلب البيانات وتعديلها.

مصطلح REST هو اختصار لعبارة نقل الحالة التمثيلية. وفي سياق Google API، يشير المصطلح إلى استخدام أفعال HTTP لاسترداد وتعديل تمثيلات البيانات التي تخزّنها Google.

في نظام REST، يتم تخزين الموارد في متجر بيانات. يرسل العميل طلبًا يقضي بتنفيذ الخادم لإجراء محدد (مثلاً إنشاء مورد أو استرداده أو تعديله أو حذفه)، وينفّذ الخادم الإجراء ويرسل ردًّا غالبًا ما يكون على شكل تمثيل للمورد المحدد.

في REST API التابع لـ Google، يحدد العميل إجراءً باستخدام فعل HTTP، مثل POST أو GET أو PUT أو DELETE. ويحدد موردًا حسب معرف موارد منتظم (URI) فريد عالميًا يكون على الشكل التالي:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

بما أنّ كل الموارد تملك معرفات منتظمة لبروتوكولات HTTP يمكن الوصول إليها، يتيح REST تخزين البيانات مؤقتًا وتم تحسينه ليعمل مع بنية الويب الأساسية الموزَّعة.

قد تكون تعريفات الطرق في مستند معايير HTTP 1.1 مفيدة لك، وهي تشمل مواصفات عن GET وPOST وPUT وDELETE.

‫REST في Google Street View Publish API

ترتبط مباشرةً عمليات Google Street View Publish API بأفعال HTTP الخاصة بـ REST.

في ما يلي التنسيقات المحددة لمعرّفات الموارد المنتظمة الخاصة بـ Google Street View Publish API:

https://www.googleapis.com/streetviewpublish/v1/resourcePath?parameters

يمكنك العثور على تلخيص لمجموعة المعرّفات الكاملة لكل عملية متاحة في واجهة برمجة التطبيقات في مستند مرجع Google Street View Publish API.

تعرَّف على أساسيات JSON

تعرض Google Street View Publish API البيانات بتنسيق JSON.

‫JSON‏ (JavaScript Object Notation) هو تنسيق بيانات شائع مستقل عن اللغة يقدّم تمثيلاً نصيًا بسيطًا عن بنى عشوائية للبيانات. لمزيد من المعلومات، انتقِل إلى json.org‏.