این محصول یا ویژگی در وضعیت Legacy است. برای اطلاعات بیشتر در مورد مرحله Legacy و نحوه انتقال از Legacy به سرویس‌های جدیدتر، به
محصولات و ویژگی‌های Legacy مراجعه کنید.، این محصول یا ویژگی در وضعیت Legacy است. برای اطلاعات بیشتر در مورد مرحله Legacy و نحوه انتقال از Legacy به سرویس‌های جدیدتر، به
محصولات و ویژگی‌های Legacy مراجعه کنید.، این محصول یا ویژگی در وضعیت Legacy است. برای اطلاعات بیشتر در مورد مرحله Legacy و نحوه انتقال از Legacy به سرویس‌های جدیدتر، به
محصولات و ویژگی‌های Legacy مراجعه کنید.، این محصول یا ویژگی در وضعیت Legacy است. برای اطلاعات بیشتر درباره مرحله Legacy و نحوه انتقال از Legacy به سرویس‌های جدیدتر، به
محصولات و ویژگی‌های Legacy مراجعه کنید.
پروژه 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 ها را فعال کنید
برای استفاده از پلتفرم نقشه های گوگل، باید API ها یا SDK هایی را که قصد دارید در پروژه خود استفاده کنید، فعال کنید.
Cloud SDK
gcloud services enable \
--project "PROJECT" \
"distance-matrix-backend.googleapis.com" درباره Google Cloud SDK ، نصب Cloud SDK و دستورات زیر بیشتر بخوانید:
مشاهده APIهای فعال
کنسول
برای مشاهده API ها یا SDK هایی که فعال کرده اید، به صفحه پلتفرم Google Maps در کنسول Cloud بروید:
به صفحه پلتفرم نقشه های گوگل بروید- API های اضافی: این API یا SDK ها فعال نیستند.
- اگر کارت‌هایی را برای هر یک از APIها و سرویس‌های Map می‌بینید، هیچ API یا SDK فعال نشده است.
یک پروژه را تعطیل کنید
می توانید با خاموش کردن آن پروژه، صورتحساب را غیرفعال کنید و تمام منابع Cloud را که در پروژه Cloud شما استفاده می شود آزاد کنید:
بعدش چی
پس از راه اندازی پروژه Google Cloud خود، برای استفاده از Distance Matrix API باید کلید API خود را ایجاد و ایمن کنید:
از کلیدهای API استفاده کنید
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis guide explains how to set up a Google Cloud project for using Google Maps Platform APIs, including creating a project, enabling billing, and enabling APIs.\u003c/p\u003e\n"],["\u003cp\u003eYou must create a Google Cloud project to manage services, credentials, billing, and APIs; billing is required but you are only charged for usage exceeding the free quota.\u003c/p\u003e\n"],["\u003cp\u003eBefore using Google Maps Platform, you need to enable the specific APIs or SDKs you intend to use within your project.\u003c/p\u003e\n"],["\u003cp\u003eYou can shut down a project to disable billing and release Cloud resources when no longer needed.\u003c/p\u003e\n"],["\u003cp\u003eAfter setting up your project, create and secure an API key to use the Google Maps Platform APIs.\u003c/p\u003e\n"]]],["To use Google Maps Platform APIs, you must first create a Google Cloud project, including setting the project name, ID, and linking a billing account. Billing must be enabled, though charges only occur beyond the free monthly quota. Next, enable the specific APIs or SDKs needed for your project. You can use the console or `gcloud` to manage these steps and view enabled APIs. If a project is no longer needed, it can be shut down to disable billing and release its resources.\n"],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_distance-matrix-backend)\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_distance-matrix-backend)\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\nTo use Google Maps Platform, you must enable the APIs or SDKs you plan to use with your project.\n\n### Console\n\n\n[Enable the Distance Matrix API](https://console.cloud.google.com/apis/library/distance-matrix-backend.googleapis.com?utm_source=Docs_EnableAPIs&utm_content=Docs_distance-matrix-backend)\n\n### Cloud SDK\n\n```bash\ngcloud services enable \\\n --project \"\u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e\" \\\n \"distance-matrix-backend.googleapis.com\"\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 enable`](https://cloud.google.com/sdk/gcloud/reference/services/enable)\n- [`gcloud services disable`](https://cloud.google.com/sdk/gcloud/reference/services/disable)\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_distance-matrix-backend)\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_distance-matrix-backend)\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\nAfter setting up your Google Cloud project, you must create and secure\nyour API Key to use the Distance Matrix API:\n\n[Use API Keys](/maps/documentation/distance-matrix/get-api-key)"]]
