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

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

الحصول على حساب Google

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

في واجهات برمجة التطبيقات RESTful من Google، يحدّد العميل إجراءً باستخدام فعل HTTP مثل POST أو GET أو PUT أو DELETE. يحدد موردًا من خلال معرف موارد منتظم (URI) فريد عالميًا بالصيغة التالية:

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

ونظرًا لأن جميع موارد واجهة برمجة التطبيقات تتضمن معرفات موارد منتظمة (URI) فريدة يمكن الوصول إليها عبر HTTP، فإن REST تتيح التخزين المؤقت للبيانات ويتم تحسينها للعمل مع البنية الأساسية الموزعة على الويب.

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

واجهة برمجة التطبيقات REST في واجهة برمجة التطبيقات لنشر التجوُّل الافتراضي من Google

تربط عمليات واجهة برمجة التطبيقات في Google Street View Publish مباشرةً بأفعال REST HTTP.

في ما يلي التنسيقات المحددة لمعرّفات الموارد المنتظمة (URI) لواجهة برمجة التطبيقات الخاصة بخدمة "التجوّل الافتراضي من Google":

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

يتم تلخيص المجموعة الكاملة من معرفات الموارد المنتظمة (URI) المستخدمة لكل عملية متوافقة في واجهة برمجة التطبيقات في مستند مرجع واجهة برمجة التطبيقات لنشر التجوّل الافتراضي من Google.

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

تعرض واجهة برمجة التطبيقات Google Street View Publish البيانات بتنسيق JSON.

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