science این محصول یا ویژگی در پیش نمایش (قبل از GA) است. محصولات و ویژگی‌های Pre-GA ممکن است پشتیبانی محدودی داشته باشند، و تغییرات در محصولات و ویژگی‌های pre-GA ممکن است با سایر نسخه‌های pre-GA سازگار نباشد. پیشنهادات قبل از GA تحت پوشش
شرایط خاص سرویس پلتفرم Google Maps هستند. برای اطلاعات بیشتر، به
توضیحات مرحله راه اندازی مراجعه کنید.
پروژه Google Cloud خود را راه اندازی کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این راهنما نحوه راه‌اندازی پروژه Google Cloud خود را قبل از استفاده از APIهای پلتفرم Google Maps نشان می‌دهد. در حالی که ممکن است برخی از این مراحل را در صفحه شروع با Google Maps Platform کامل کرده باشید، این سند دستورالعمل های مفید و اضافی را برای مدیریت پروژه های شما ارائه می دهد.
یک پروژه ایجاد کنید
برای استفاده از پلتفرم نقشه های گوگل، باید پروژه ای برای مدیریت خدمات، اعتبارنامه ها، صورتحساب، API ها و SDK داشته باشید.
تنظیم صورتحساب برای هر پروژه مورد نیاز است، اما تنها در صورتی از شما هزینه دریافت می‌شود که پروژه از سهمیه خدمات بدون هزینه خود فراتر رود.
برای ایجاد یک پروژه Cloud با فعال بودن صورتحساب:
کنسول
یک پروژه Google Cloud جدید در کنسول Cloud ایجاد کنید:
پروژه جدید ایجاد کنید در صفحه پروژه جدید ، اطلاعات مورد نیاز را پر کنید:
نام پروژه: پیش فرض را بپذیرید یا یک نام سفارشی وارد کنید.
شما می توانید نام پروژه را در هر زمان تغییر دهید. برای اطلاعات بیشتر، به شناسایی پروژه ها مراجعه کنید.
شناسه پروژه: پیش‌فرض را بپذیرید یا روی EDIT کلیک کنید تا شناسه سفارشی‌سازی‌شده‌ای را وارد کنید که Google API از آن به‌عنوان یک شناسه منحصربه‌فرد برای پروژه شما استفاده می‌کند.
پس از ایجاد پروژه، نمی توانید شناسه پروژه را تغییر دهید، بنابراین شناسه ای را انتخاب کنید که در طول عمر پروژه راحت از آن استفاده کنید. هیچ اطلاعات حساسی را در شناسه پروژه خود وارد نکنید.
حساب صورتحساب: یک حساب صورتحساب برای پروژه انتخاب کنید. اگر حساب صورتحساب راه‌اندازی نکرده‌اید یا فقط یک حساب صورتحساب دارید، این گزینه را نمی‌بینید.
برای مرتبط کردن پروژه با حساب صورتحساب، باید مدیر حساب صورتحساب یا مدیر صورتحساب پروژه باشید. برای اطلاعات بیشتر، به اسناد کنترل دسترسی صورتحساب مراجعه کنید.
مکان: اگر سازمانی دارید که می خواهید پروژه خود را به آن پیوند دهید، روی Browse کلیک کنید و آن را انتخاب کنید. در غیر این صورت، "بدون سازمان" را انتخاب کنید.
برای اطلاعات بیشتر، به ایجاد و مدیریت پوشه‌ها و روابط بین سازمان‌ها، پروژه‌ها و حساب‌های صورتحساب مراجعه کنید.
ایجاد را انتخاب کنید.
فعال کردن صورتحساب
برای استقرار برنامه های خود، باید صورتحساب را فعال کنید. اگر در سهمیه ماهانه خود باقی بمانید، هزینه ای از حساب شما کسر نمی شود. اگر برنامه شما به منابعی بیش از سهمیه ماهانه نیاز دارد، هزینه استفاده اضافی از شما کسر می شود.
اگر هنگام ایجاد یک پروژه Cloud یک حساب صورتحساب دارید، صورتحساب به طور خودکار در آن پروژه فعال می‌شود.
برای فعال کردن صورتحساب در پروژه Cloud:
- در کنسول Cloud، به صفحه صورتحساب بروید:
به صفحه صورتحساب بروید - یک پروژه Cloud را انتخاب یا ایجاد کنید.
- بسته به اینکه آیا یک حساب صورتحساب وجود دارد یا اینکه پروژه Cloud انتخاب شده با یک حساب مرتبط است، صفحه صورتحساب یکی از موارد زیر را نمایش می دهد:
- اگر صورتحساب قبلاً برای پروژه Cloud انتخاب شده فعال شده باشد، جزئیات مربوط به حساب صورتحساب فهرست شده است.
- اگر هیچ حساب صورتحساب وجود ندارد، از شما خواسته می‌شود یک حساب صورتحساب ایجاد کنید و آن را با پروژه Cloud انتخاب شده مرتبط کنید.
- اگر یک حساب صورتحساب وجود داشته باشد، اگر پروژه Cloud انتخابی قبلاً با حساب صورتحساب مرتبط نیست، از شما خواسته می‌شود که صورتحساب را فعال کنید. همچنین می‌توانید لغو و سپس ایجاد حساب را برای ایجاد و مرتبط کردن یک حساب صورتحساب جدید انتخاب کنید.
پس از فعال کردن صورتحساب، هیچ محدودیتی برای مبلغی که ممکن است از شما دریافت شود وجود ندارد. برای به دست آوردن کنترل بیشتر بر هزینه های خود، می توانید بودجه ایجاد کنید و هشدارها را تنظیم کنید . برای اطلاعات بیشتر، صورتحساب را ببینید.
API ها را فعال کنید
Cloud SDK
قبل از استفاده از دستور زیر، دستور زیر را جایگزین کنید:
- RESOURCE_TYPE با نوع منبعی که می‌خواهید یک عامل سرویس برای آن ایجاد کنید. از
project ، folder یا organization استفاده کنید. - RESOURCE_ID با شناسه پروژه، پوشه یا سازمانی Google Cloud که می‌خواهید یک عامل خدمات برای آن ایجاد کنید. شناسه‌های پروژه مانند
my-project رشته‌های الفبایی هستند. شناسه‌های پوشه و سازمان مانند 123456789012 عددی هستند.
gcloud beta services identity create \
--service=analyticshub.googleapis.com \
--RESOURCE_TYPE=RESOURCE_ID
مشاهده APIهای فعال
کنسول
برای مشاهده API ها یا SDK هایی که فعال کرده اید، به صفحه پلتفرم Google Maps در کنسول Cloud بروید:
به صفحه پلتفرم نقشه های گوگل بروید- API های اضافی: این API یا SDK ها فعال نیستند.
- اگر کارت‌هایی را برای هر یک از APIها و سرویس‌های Map می‌بینید، هیچ API یا SDK فعال نشده است.
یک پروژه را تعطیل کنید
می توانید با خاموش کردن آن پروژه، صورتحساب را غیرفعال کنید و تمام منابع Cloud را که در پروژه Cloud شما استفاده می شود آزاد کنید:
بعدش چی
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Set up your Google Cloud project\n\nThis guide shows how to set up your Google Cloud project before using\nthe Google Maps Platform APIs. While you may have completed some of these\nsteps in the\n\n[Getting started with Google Maps Platform](/maps/get-started) page,\nthis document provides additional, useful instructions for managing your projects.\n\nCreate a project\n----------------\n\nTo use Google Maps Platform, you must have a project to manage services,\ncredentials, billing, APIs, and SDKs.\n\n[Billing setup](#billing) is required for each project, but you will only be charged if a\nproject exceeds its [quota](/maps/billing-and-pricing/billing#monthly-credit) of no-charge services.\n\nTo create a Cloud project with billing enabled: \n\n### Console\n\n1. Create a new Google Cloud project in the Cloud console:\n\n [Create new project](https://console.cloud.google.com/projectcreate?utm_source=Docs_NewProject&utm_content=Docs_CONSOLE_ID)\n2. On the **New Project** page, fill in the required information:\n\n - **Project name:** Accept the default or enter a customized name.\n\n You can change the project name at any time. For more information, see\n [Identifying projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects).\n - **Project ID:** Accept the default or click **EDIT** to enter a\n customized ID that Google APIs use as a unique identifier for your project.\n\n After you create the project, you *cannot* change the project ID, so\n choose an ID that you'll be comfortable using for the lifetime of the\n project. Don't include any sensitive information in your project ID.\n - **Billing account:** Select a billing account for the project. If you\n haven't set up a billing account or only have one billing account, you\n won't see this option.\n\n You must be a Billing Account Administrator or Project Billing Manager\n to associate a project with a billing account. For more information, see\n [the billing access control documentation](https://cloud.google.com/billing/docs/how-to/billing-access#overview_of_billing_roles_in).\n - **Location:** If you have an organization you want to link your project\n to, click **Browse** and select it; otherwise, choose \"No organization\".\n\n For more information, see [Creating and Managing Folders](https://cloud.google.com/resource-manager/docs/creating-managing-folders)\n and [Relationships between organizations, projects, and billing accounts](https://cloud.google.com/billing/docs/how-to/billing-access#relationships-between-resources).\n3. Select **Create**.\n\n### gcloud\n\n```bash\ngcloud projects create \"\u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e\"\n```\n\nRead more about the\n[Google Cloud SDK](https://cloud.google.com/sdk)\n,\n[Cloud SDK installation](https://cloud.google.com/sdk/docs/install)\n, and the following commands:\n\n- [`gcloud projects create`](https://cloud.google.com/sdk/gcloud/reference/projects/create)\n\nEnable billing\n--------------\n\nTo deploy your apps, you must enable billing. Your account won't be charged\nif you stay within your [monthly quota](/maps/billing-and-pricing/billing#monthly-credit).\nIf your application needs resources that exceed the monthly quota, you will be\ncharged for the additional usage.\n\nIf you have a billing account when you create a Cloud\nproject, then billing is automatically enabled on that project.\n\nTo enable billing on a Cloud project:\n\n1. In the Cloud console, go to the Billing page: \n [Go to the Billing page](https://console.cloud.google.com/projectselector/billing?utm_source=Docs_Billing&utm_content=Docs_CONSOLE_ID)\n2. Select or create a Cloud project.\n3. Depending on if a billing account exists or if the selected Cloud project is associated with an account, the Billing page displays one of the following:\n - If billing is already enabled for the selected Cloud project, then the details about the billing account are listed.\n - If no billing account exists, you are prompted to create a billing account and associate it with the selected Cloud project.\n - If a billing account exists, you are prompted to enable billing if the selected Cloud project is not already associated with a billing account. You can also select **Cancel** and then select **Create account** to create and associate a new billing account.\n\nAfter you enable billing, there is no limit to the amount that you might\nbe charged. To gain more control over your costs, you can\n[create\na budget and set alerts](/maps/billing-and-pricing/billing#creating-budgets-and-set-alerts). For more information, see [Billing](/maps/billing-and-pricing/billing).\n\nEnable APIs\n-----------\n\n### Console\n\n\n[Enable Vertex AI](https://console.cloud.google.com/apis/library/aiplatform.googleapis.com)\n\n\n[Enable BigQuery](https://console.cloud.google.com/apis/library/bigquery.googleapis.com)\n\n\n[Enable Cloud Storage](https://console.cloud.google.com/apis/library/storage-component.googleapis.com)\n\n\n[Enable Analytics Hub API](https://console.cloud.google.com/apis/library/analyticshub.googleapis.com)\n\n### Cloud SDK\n\nBefore using the command below, replace the following:\n\n- \u003cvar label=\"RESOURCE_TYPE\" translate=\"no\"\u003eRESOURCE_TYPE\u003c/var\u003e with the type of resource that you want to create a service agent for. Use `project`, `folder`, or `organization`.\n- \u003cvar label=\"RESOURCE_ID\" translate=\"no\"\u003eRESOURCE_ID\u003c/var\u003e with the ID of the Google Cloud project, folder, or organization that you want to create a service agent for. Project IDs are alphanumeric strings, like `my-project`. Folder and organization IDs are numeric, like `123456789012`.\n\n```bash\ngcloud beta services identity create \\\n --service=analyticshub.googleapis.com \\\n --RESOURCE_TYPE=RESOURCE_ID\n```\n\nView enabled APIs\n-----------------\n\n### Console\n\nTo view the APIs or SDKs you have enabled, go to the Google Maps Platform page\nin the Cloud console:\n[Go to Google Maps Platform page](https://console.cloud.google.com/project/_/google/maps-apis/api-list?utm_source=Docs_ProjectViewAPI&utm_content=Docs_CONSOLE_ID)\n\n- Additional APIs: These API or SDKs are not enabled.\n- If you see cards for each Map APIs and services, no APIs or SDKs have been enabled.\n\n### gcloud\n\n```bash\ngcloud services list --project \"\u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e\"\n```\n\nRead more about the\n[Google Cloud SDK](https://cloud.google.com/sdk)\n,\n[Cloud SDK installation](https://cloud.google.com/sdk/docs/install)\n, and the following commands:\n\n- [`gcloud services list`](https://cloud.google.com/sdk/gcloud/reference/services/list)\n\nShut down a project\n-------------------\n\nYou can disable billing and release all the Cloud resources that\nare being used in your Cloud project by shutting down\nthat project: \n\n### Console\n\n1. Go to the Projects page:\n\n [Go to the Projects page](https://console.cloud.google.com/iam-admin/projects?utm_source=Docs_ProjectShutdown&utm_content=Docs_CONSOLE_ID)\n2. Select the Cloud project that you want to shut down,\n then click **Delete**.\n\nFor more information about managing your Cloud\nprojects, see [Cloud Resource Manager: creating, shutting down, and restoring projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects).\n\n### gcloud\n\n```bash\ngcloud projects delete \"\u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e\"\n```\n\nRead more about the\n[Google Cloud SDK](https://cloud.google.com/sdk)\n,\n[Cloud SDK installation](https://cloud.google.com/sdk/docs/install)\n, and the following commands:\n\n- [`gcloud projects delete`](https://cloud.google.com/sdk/gcloud/reference/projects/delete)\n\nWhat's next\n-----------\n\n- [Classify images](/maps/documentation/imagery-insights/get-started).\n- [Review the table schemas](/maps/documentation/imagery-insights/reference)."]]
