هذا المنتج أو هذه الميزة في حالة "قديم". لمزيد من المعلومات عن المرحلة القديمة وكيفية نقل البيانات من الخدمات القديمة إلى الخدمات الأحدث، يُرجى الاطّلاع على
المنتجات والميزات القديمة.
إعداد مشروعك على Google Cloud
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوضّح هذا الدليل كيفية إعداد مشروعك على Google Cloud قبل استخدام واجهات برمجة التطبيقات في "منصة خرائط Google". على الرغم من أنّك ربما أكملت بعض هذه الخطوات في صفحة البدء باستخدام "منصة خرائط Google"، يقدّم هذا المستند تعليمات إضافية ومفيدة لإدارة مشاريعك.
إنشاء مشروع
لاستخدام Google Maps Platform، يجب أن يكون لديك مشروع لإدارة الخدمات وبيانات الاعتماد والفوترة وواجهات برمجة التطبيقات وحِزم تطوير البرامج (SDK).
يجب إعداد الفوترة لكل مشروع، ولكن لن يتم تحصيل رسوم منك إلا إذا تجاوز المشروع حصته من الخدمات غير المدفوعة.
لإنشاء مشروع على السحابة الإلكترونية مع تفعيل الفوترة، اتّبِع الخطوات التالية:
وحدة التحكّم
-
أنشِئ مشروعًا جديدًا على Google Cloud في Cloud Console:
إنشاء مشروع جديد
-
في صفحة مشروع جديد، املأ المعلومات المطلوبة:
-
اسم المشروع: يمكنك قبول الاسم التلقائي أو إدخال اسم مخصّص.
يمكنك تغيير اسم المشروع في أي وقت. لمزيد من المعلومات، يُرجى الاطّلاع على
تحديد المشاريع.
-
معرّف المشروع: اقبل المعرّف التلقائي أو انقر على تعديل لإدخال معرّف مخصّص تستخدمه واجهات Google API كمعرّف فريد لمشروعك.
بعد إنشاء المشروع، لا يمكنك تغيير معرّف المشروع، لذا اختَر معرّفًا يناسبك استخدامه طوال مدة المشروع. يُرجى عدم تضمين أي معلومات حساسة في معرّف مشروعك.
-
حساب الفوترة: اختَر حساب فوترة للمشروع. لن يظهر لك هذا الخيار إذا لم تكن قد أعددت حساب فوترة أو إذا كان لديك حساب فوترة واحد فقط.
يجب أن تكون مشرف حساب الفوترة أو مدير فوترة المشروع
لربط مشروع بحساب فوترة. لمزيد من المعلومات، يُرجى الاطّلاع على
مستندات التحكّم في الوصول إلى الفوترة.
-
الموقع الجغرافي: إذا كان لديك مؤسسة تريد ربط مشروعك بها، انقر على تصفّح واختَرها، وإلا اختَر "بدون مؤسسة".
لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء المجلدات وإدارتها والعلاقات بين المؤسسات والمشاريع وحسابات الفوترة.
انقر على إنشاء.
تفعيل الفوترة
لتوزيع تطبيقاتك، يجب تفعيل الفوترة. لن يتم تحصيل رسوم من حسابك إذا بقيت ضمن الحصة الشهرية.
إذا كان تطبيقك يحتاج إلى موارد تتجاوز الحصة الشهرية، سيتم تحصيل رسوم منك مقابل الاستخدام الإضافي.
إذا كان لديك حساب فوترة عند إنشاء مشروع على Cloud، سيتم تلقائيًا تفعيل الفوترة في هذا المشروع.
لتفعيل الفوترة في مشروع على السحابة الإلكترونية، اتّبِع الخطوات التالية:
- في Cloud Console، انتقِل إلى صفحة "الفوترة":
الانتقال إلى صفحة "الفوترة"
- اختَر مشروعًا على السحابة الإلكترونية أو أنشِئ مشروعًا.
- استنادًا إلى ما إذا كان حساب الفوترة متوفّرًا أو ما إذا كان مشروع Cloud المحدّد مرتبطًا بحساب، ستعرض صفحة "الفوترة" أحد الخيارَين التاليَين:
- إذا كانت الفوترة مفعّلة مسبقًا لمشروع Cloud المحدّد، سيتم عرض تفاصيل حساب الفوترة.
- إذا لم يكن هناك حساب فوترة، سيُطلب منك إنشاء حساب فوترة وربطه بمشروع Cloud المحدّد.
- إذا كان حساب الفوترة متوفّرًا، سيُطلب منك تفعيل الفوترة إذا لم يكن مشروع Cloud المحدّد مرتبطًا بحساب فوترة. يمكنك أيضًا النقر على إلغاء، ثم النقر على إنشاء حساب لإنشاء حساب فوترة جديد وربطه.
بعد تفعيل الفوترة، لن يكون هناك حدّ أقصى للمبلغ الذي قد يتم تحصيله منك. للتحكّم بشكلٍ أكبر في تكاليفك، يمكنك إنشاء
ميزانية وضبط تنبيهات. لمزيد من المعلومات، يُرجى الاطّلاع على الفوترة.
تفعيل واجهات برمجة التطبيقات
لاستخدام Google Maps Platform، يجب تفعيل واجهات برمجة التطبيقات أو حِزم SDK التي تخطّط لاستخدامها مع مشروعك.
SDK للسحاب
gcloud services enable \
--project "PROJECT" \
"distance-matrix-backend.googleapis.com"
يمكنك الاطّلاع على مزيد من المعلومات حول
Google Cloud SDK
و
تثبيت Cloud SDK
والأوامر التالية:
عرض واجهات برمجة التطبيقات المفعَّلة
وحدة التحكّم
لعرض واجهات برمجة التطبيقات أو حِزم تطوير البرامج (SDK) التي فعّلتها، انتقِل إلى صفحة Google Maps Platform
في Cloud Console:
الانتقال إلى صفحة "منصة خرائط Google"
- واجهات برمجة التطبيقات الإضافية: لم يتم تفعيل واجهات برمجة التطبيقات أو حِزم تطوير البرامج هذه.
- إذا ظهرت بطاقات لكل واجهات برمجة التطبيقات والخدمات في "خرائط Google"، يعني ذلك أنّه لم يتم تفعيل أي واجهات برمجة تطبيقات أو حِزم SDK.
إيقاف مشروع
يمكنك إيقاف الفوترة وإلغاء جميع موارد السحابة الإلكترونية المستخدَمة في مشروعك على السحابة الإلكترونية من خلال إيقاف هذا المشروع:
الخطوات التالية
بعد إعداد مشروعك على Google Cloud، عليك إنشاء مفتاح واجهة برمجة التطبيقات وتأمينه لاستخدام Distance Matrix API:
استخدام مفاتيح واجهة برمجة التطبيقات
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)"]]
