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