نمای خیابان انتشار API نمای کلی
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
مقدمه
این سند برای توسعه دهندگانی در نظر گرفته شده است که می خواهند برنامه هایی بنویسند که به کاربران امکان می دهد عکس های 360 را در Google Street View آپلود کنند تا بتوانند به صورت عمومی در Google Maps مشاهده شوند.
قبل از شروع
برای دسترسی به Google API Console، درخواست کلید API و ثبت برنامه خود، به یک حساب Google نیاز دارید.
یک پروژه در Google Developers Console ایجاد کنید و اعتبارنامه مجوز را دریافت کنید تا برنامه شما بتواند درخواست های API را ارسال کند.
پس از ایجاد پروژه خود، مطمئن شوید که Street View Publish API یکی از خدماتی است که برنامه شما برای استفاده از آن ثبت شده است:
- به کنسول API بروید و پروژه ای را که به تازگی ثبت کرده اید انتخاب کنید.
- از صفحه API های فعال شده دیدن کنید. مطمئن شوید که Google Street View API در لیست APIهای فعال قرار دارد. اگر اینطور نیست، کتابخانه API را باز کنید و API را فعال کنید.
اگر برنامه شما از هر روش API که نیاز به مجوز کاربر دارد استفاده می کند، راهنمای احراز هویت را بخوانید تا نحوه اجرای مجوز OAuth 2.0 را بیاموزید.
با مفاهیم اصلی فرمت داده های نشانه گذاری شی جاوا اسکریپت (JSON) آشنا شوید. JSON یک استاندارد باز متداول و مستقل از زبان است که یک نمایش متنی ساده و قابل خواندن توسط انسان از داده ها (به عنوان جفت ویژگی-مقدار) ارائه می دهد. برای اطلاعات بیشتر، به json.org مراجعه کنید.
به یاد داشته باشید که عکس‌های شما برای انتشار به ابرداده‌هایی نیاز دارند که در فراداده Photo Sphere XMP توضیح داده شده است.
تجربه یک دقیقه ای: APIs Explorer
برای بازی کردن و دیدن کارهایی که API می تواند انجام دهد، بدون نوشتن هیچ کدی، به APIs Explorer مراجعه کنید. لذت آنی!
خودتان آن را امتحان کنید!
برای آموزش گام به گام نحوه راه‌اندازی و اجرا، دستورالعمل‌های این راهنما را دنبال کنید.
مرجع
برای جستجوی نوع یا روش منبع خاص، به مرجع مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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)."]]
