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

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

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

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

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

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

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

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

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

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

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

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

تعلُّم أساسيات REST

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

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

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

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

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

في واجهات برمجة تطبيقات RESTful في Google\u3d، يحدد العميل إجراءً باستخدام فعل 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 Publish التجوّل الافتراضي لأفعال HTTP باستخدام REST مباشرةً.

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

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

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

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

تعرض واجهة برمجة التطبيقات Google التجوّل الافتراضي للنشر البيانات بتنسيق JSON.

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