نظرة عامة على Street View Publish API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
مقدمة
هذا المستند مخصّص للمطوّرين الذين يريدون كتابة تطبيقات تتيح للمستخدمين تحميل صور بزاوية 360 درجة إلى "التجوّل الافتراضي من Google"، حتى يمكن عرضها علنًا على "خرائط Google".
قبل البدء
-
تحتاج إلى حساب Google للوصول إلى "وحدة تحكّم واجهة برمجة التطبيقات من Google" وطلب مفتاح واجهة برمجة التطبيقات وتسجيل تطبيقك.
-
يمكنك إنشاء مشروع في Google Developers Console والحصول على بيانات اعتماد التفويض حتى يتمكّن تطبيقك من إرسال طلبات من واجهة برمجة التطبيقات.
-
بعد إنشاء مشروعك، تأكَّد من أنّ واجهة Street View Publish API هي إحدى الخدمات التي تم تسجيل تطبيقك لاستخدامها:
- انتقِل إلى وحدة تحكم واجهة برمجة التطبيقات واختَر المشروع الذي سجّلته للتو.
- انتقِل إلى صفحة "واجهات برمجة التطبيقات المفعّلة". تأكَّد من أنّ واجهة برمجة تطبيقات "التجوّل الافتراضي من Google" مُدرَجة في قائمة واجهات برمجة التطبيقات المفعَّلة. وإذا لم تكن كذلك، يمكنك فتح مكتبة واجهة برمجة التطبيقات وتفعيل واجهة برمجة التطبيقات.
-
إذا كان تطبيقك سيستخدم أيًا من أساليب واجهة برمجة التطبيقات التي تتطلب ترخيص المستخدم، فاقرأ دليل المصادقة للتعرف على كيفية تطبيق ترخيص OAuth 2.0.
-
تعرَّف على المفاهيم الأساسية لتنسيق بيانات JavaScript Object Notation (JSON). JSON هو معيار مفتوح شائع ومستقل عن اللغة يوفّر تمثيلاً نصيًا بسيطًا للبيانات (كأزواج السمات والقيمة). لمزيد من المعلومات، راجع json.org.
-
يُرجى العِلم أنّ نشر صورك يتطلّب توفّر البيانات الوصفية الموضّحة في البيانات الوصفية XMP لصور بانورامية 360 درجة.
تجربة مدّتها دقيقة واحدة: "مستكشف واجهات برمجة التطبيقات"
للاطّلاع على إمكانيات واجهة برمجة التطبيقات بدون كتابة أي رمز برمجي، يمكنك الانتقال إلى
مستكشف واجهات برمجة التطبيقات.
إشباع الرغبات الفورية
جربه بنفسك!
للاطّلاع على دليل توجيهي مفصَّل يشرح كيفية بدء عملية الإعداد والتشغيل، يُرجى اتّباع التعليمات الواردة في هذا الدليل.
مَراجع
للبحث عن نوع أو طريقة معيّنة من الموارد، يمكنك الاطّلاع على المرجع.
مكتبات العملاء
اطّلِع على مكتبات البرامج المتاحة للعملاء.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis documentation guides developers on how to build applications enabling users to upload 360° photos to Google Street View for public viewing on Google Maps.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers need a Google Account, a project in the Google Developers Console with the Street View Publish API enabled, and potentially OAuth 2.0 authorization for user-specific actions.\u003c/p\u003e\n"],["\u003cp\u003ePhotos must contain specific metadata outlined in the Photo Sphere XMP Metadata documentation to be successfully published.\u003c/p\u003e\n"],["\u003cp\u003eThe API can be explored without coding through the provided APIs Explorer for immediate experimentation.\u003c/p\u003e\n"],["\u003cp\u003eA step-by-step tutorial and comprehensive reference materials are available for developers to quickly get started and delve deeper into specific functionalities.\u003c/p\u003e\n"]]],["Developers creating apps for uploading 360 photos to Google Street View must first create a Google Account and a project in the Google Developers Console to get authorization credentials. They need to enable the Street View Publish API in their project and, if needed, implement OAuth 2.0 for user authorization. Understanding JSON data format and adding Photo Sphere XMP Metadata to photos is crucial. Developers can experiment using the APIs Explorer or follow a tutorial guide.\n"],null,["# Street View Publish API Overview\n\nIntroduction\n------------\n\nThis document is intended for developers who want to write applications that allow users to upload 360 photos to Google Street View, so that they can be viewed publicly on Google Maps.\n\n### Before you start\n\n1. You need a [Google Account](https://www.google.com/accounts/NewAccount) to access the Google API Console, request an API key, and register your application.\n\n2. Create a project in the [Google Developers Console](https://console.developers.google.com) and obtain [authorization credentials](https://console.developers.google.com/apis/credentials) so your application can submit API requests.\n\n3. After creating your project, make sure the Street View Publish API is one of the services that your application is registered to use:\n\n \u003cbr /\u003e\n\n 1. Go to the [API Console](https://console.cloud.google.com/) and select the project that you just registered.\n 2. Visit the [Enabled APIs page](https://console.cloud.google.com/apis/enabled). Make sure that the Google Street View API is on the list of enabled APIs. If it isn't, then [open the API Library](https://console.cloud.google.com/apis/library) and enable the API.\n\n \u003cbr /\u003e\n\n4. If your application will use any API methods that require user authorization, read the [authentication](/streetview/publish/authorizing) guide to learn how to implement OAuth 2.0 authorization.\n\n5. Familiarize yourself with the core concepts of the JavaScript Object Notation (JSON) data format. JSON is a common, language-independent open standard that provides a simple, human-readable text representation of data (as attribute--value pairs). For more information, see [json.org](http://json.org).\n\n6. Remember your photos need the metadata described in [Photo Sphere XMP Metadata](/streetview/spherical-metadata) in order to be published.\n\nThe one-minute experience: APIs Explorer\n----------------------------------------\n\nTo play around and see what the API can do, without writing any code, visit\nthe [APIs Explorer](https://developers.google.com/apis-explorer/#p/streetviewpublish/v1/).\nInstant gratification!\n\nTry it yourself!\n----------------\n\nFor a step-by-step tutorial explaining how to get up and running, follow the instructions in [this guide](/streetview/publish/first-app).\n\nReference\n---------\n\nTo look up a particular resource type or method, see the [Reference](/streetview/publish/reference/rest).\n\nClient libraries\n----------------\n\nCheck out the available client [libraries](/streetview/publish/libraries)."]]
