تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ملاحظة مهمة: لم تعُد خطة Google Maps Platform Premium متاحة لتسجيل اشتراكات جديدة أو للعملاء الجدد.
مرحبًا بك في الخطة المميّزة في "منصة خرائط Google"
بعد الاشتراك في خطة Google Maps Platform Premium، ستصلك
رسالة ترحيب من Google على عنوان البريد الإلكتروني المخصّص للتواصل الذي قدّمته.
تحتوي رسالة الترحيب على المعلومات التي تحتاجها للبدء:
رقم تعريف المشروع
معرِّف العميل
سر توقيع عنوان URL الخاص أو مفتاح التشفير لمعرّف العميل
حساب Google
المحتوى المضمّن في الحزمة
تتيح لك "الخطة المميّزة" الوصول إلى مجموعة خدماتنا ومستنداتنا لكل واجهة برمجة تطبيقات، بما في ذلك أدلة المطوّرين وواجهات برمجة التطبيقات المرجعية.
1 لا يتم تضمين Places API في
ترخيص تتبُّع مواد العرض في "الخطة المدفوعة". إذا كان لديك
ترخيص تتبُّع مواد العرض وأردت استخدام
Places API، يُرجى التواصل مع
فريق المبيعات في Google Maps APIs.
إعداد واجهة برمجة التطبيقات
تم تفعيل جميع واجهات برمجة التطبيقات التي اشتريتها في مشروعك على
Google Cloud Console.
للوصول إلى واجهات برمجة التطبيقات، سجِّل الدخول باستخدام
حسابك على Google، ثم اختَر
رقم تعريف المشروع الذي يبدأ بـ Google Maps APIs for Business أو Google Maps for Work أو Google Maps.
يمكنك العثور على رقم تعريف الحساب والمشروع في خطاب الترحيب.
المصادقة والتفويض
لتقديم طلبات إلى واجهات برمجة التطبيقات، عليك مصادقة تطبيقك باستخدام إما
مفتاح واجهة برمجة التطبيقات أو معرّف العميل. بالإضافة إلى ذلك، تتطلّب طلبات بعض واجهات برمجة التطبيقات أيضًا استخدام
التوقيعات الرقمية.
مفتاح واجهة برمجة التطبيقات
يمكنك استخدام مفتاح واجهة برمجة التطبيقات لمصادقة الطلبات المرسَلة إلى أيّ من واجهات برمجة التطبيقات. لإنشاء
مفتاحك، ستستخدم مشروع Cloud Console المرتبط
رقم تعريف مشروعك. باستخدام مفتاح واجهة برمجة التطبيقات، يمكنك إجراء ما يلي:
إدارة جميع واجهات برمجة التطبيقات في Cloud Console
يمكنك الوصول إلى بيانات الاستخدام في الوقت الفعلي وبيانات الاستخدام السابقة لمدة 30 يومًا لتطبيقك في "مقاييس" "منصة خرائط Google" في وحدة تحكّم Cloud.
معرِّف العميل
بدلاً من مفتاح واجهة برمجة التطبيقات، يمكنك استخدام معرّف العميل لتقديم طلبات إلى أيٍّ من
واجهات برمجة التطبيقات باستثناء ما يلي: Places API،
Geolocation API، وRoads API،
و"حزمة تطوير البرامج (SDK) للخرائط" لنظام التشغيل Android، و"حزمة تطوير البرامج (SDK) للخرائط" لنظام التشغيل iOS.
باستخدام معرّف العميل، يمكنك إجراء ما يلي:
يمكنك إدارة معرّف العميل والوصول إلى سرّ توقيع عنوان URL الخاص بك،
أو مفتاح التشفير، في وحدة تحكّم Cloud.
يمكنك الوصول إلى بيانات الاستخدام في الوقت الفعلي وبيانات الاستخدام السابقة لمدة 30 يومًا لتطبيقك من صفحة
مقاييس Cloud Console.
بالنسبة إلى معرّف العميل، سيتم استخدام تصنيف بالشكل التالي:
project_number:<YOUR_PROJECT_NUMBER>.
أضِف المَعلمة channel إلى الطلبات حتى تتمكّن من الاطّلاع على تقارير استخدام
أكثر تفصيلاً.
مكان إدارة معرِّف العميل في وحدة تحكُّم Google Cloud
تتوفّر وظيفة إدارة معرّف العميل في "الخطة المميّزة"
في
وحدة تحكّم Cloud في أسفل
صفحة "بيانات اعتماد منصة خرائط Google"، في قسم معرّف العميل.
يمكن الوصول إلى المزيد من مهام إدارة معرّف العميل، بما في ذلك تفويض عنوان URL وإدارة سر توقيع معرّف العميل، في
صفحة معرّف العميل المنفصلة، من خلال النقر على رمز
editالتعديل في أقصى يسار القسم
معرّف العميل.
التوقيعات الرقمية
بالإضافة إلى مفتاح واجهة برمجة التطبيقات أو معرّف العميل، تتطلّب الطلبات المرسَلة إلى بعض واجهات برمجة التطبيقات أيضًا استخدام
توقيع رقمي فريد للوصول إلى الحصة والميزات في
خطتك المميّزة. يمكنك إنشاء توقيعات رقمية باستخدام مفتاح توقيع عنوان URL أو مفتاح التشفير الخاصَين المتوفّرين في رسالة الترحيب
(والمتوفّرَين في وحدة تحكّم Cloud). على وجه التحديد، ستحتاج إلى
استخدام التوقيعات الرقمية إذا كنت تستخدم:
معرّف عميل مع واجهات برمجة تطبيقات خدمات الويب أو
Maps Static API أو
Street View Static API
مفتاح واجهة برمجة التطبيقات مع Maps Static API أو
Street View Static API
لمزيد من المعلومات
للحصول على تعليمات تفصيلية حول استخدام مفتاح واجهة برمجة التطبيقات أو معرّف العميل وإنشاء التوقيعات الرقمية، يُرجى الاطّلاع على نظرة عامة على المصادقة في الخطة المدفوعة.
الأسئلة الشائعة
إذا كانت لديك أسئلة حول "منصّة خرائط Google"، يمكنك الاطّلاع على ملف الأسئلة الشائعة:
بصفتك عميلًا في خطة Google Maps Platform Premium، يمكنك الوصول إلى
وحدة تحكّم Cloud، حيث يمكنك العثور على معلومات الاتصال بالدعم و
الوصول إلى الأدوات والموارد الحصرية. لمعرفة التفاصيل، يُرجى الاطّلاع على
موارد فريق دعم "منصة خرائط Google".
تاريخ التعديل الأخير: 2025-06-03 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-06-03 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Google Maps Platform Premium Plan is no longer available for sign up or new customers.\u003c/p\u003e\n"],["\u003cp\u003eThe Premium Plan offers access to a suite of Google Maps Platform APIs and SDKs, including the Maps JavaScript API, Directions API, and Maps SDK for Android.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication is required to use the APIs and can be done using an API key or Client ID, with some APIs requiring digital signatures for specific use cases.\u003c/p\u003e\n"],["\u003cp\u003ePremium Plan customers can manage their API keys, Client IDs, and digital signatures through the Google Cloud Console.\u003c/p\u003e\n"],["\u003cp\u003eSupport and resources for Premium Plan customers are available through the Google Cloud Console and dedicated FAQs.\u003c/p\u003e\n"]]],["Upon signing up for the now-unavailable Google Maps Platform Premium Plan, users received a welcome letter with a Project ID, Client ID, private URL signing secret, and Google Account details. The plan granted access to various Web APIs, Web Service APIs, and Mobile SDKs. Users could authenticate API requests using an API key or Client ID, the latter offering detailed usage reports. Some APIs required digital signatures, generated with the provided cryptographic key. The Cloud console managed these, with support information also accessible there.\n"],null,["# Premium Plan Overview\n\n**Important:** The Google Maps Platform Premium Plan is no longer available for\nsign up or new customers.\n\nWelcome to the Google Maps Platform Premium Plan\n------------------------------------------------\n\nAfter you sign up for the Google Maps Platform Premium Plan, you receive a\nwelcome letter from Google at the contact email address you provided.\nYour welcome letter has the information you need to get started:\n\n- Project ID\n- Client ID\n- Private *URL signing secret*, or cryptographic key, for your client ID\n- Google Account\n\nWhat's included in your package\n-------------------------------\n\nYour Premium Plan includes access to our suite of\nservices and documentation for each API, including developer and API\nreference guides.\n\n| Web APIs | Web Service APIs | Mobile SDKs |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------|\n| - [Maps JavaScript API](/maps/documentation/javascript) - [Maps Static API](/maps/documentation/staticmaps) - [Street View Static API](/maps/documentation/streetview) | - [Directions API (Legacy)](/maps/documentation/directions) - [Distance Matrix API (Legacy)](/maps/documentation/distancematrix) - [Roads API](/maps/documentation/roads) - [Geolocation API](/maps/documentation/geolocation/intro) - [Places API](/maps/documentation/places/web-service) ^1^ - [Geocoding API](/maps/documentation/geocoding) - [Elevation API](/maps/documentation/elevation) - [Time Zone API](/maps/documentation/timezone) | - [Maps SDK for Android](/maps/documentation/android-sdk) - [Maps SDK for iOS](/maps/documentation/ios-sdk) |\n\n^1^ The Places API isn't included with the\nPremium Plan Asset Tracking License. If you have an\nAsset Tracking License, and you want to use the\nPlaces API, then contact the Google Maps APIs Sales\nteam.\n| **Note:** The Places SDK for Android and the Places SDK for iOS are not available for sale, and therefore are not included with the Premium Plan.\n\nAPI provisioning\n----------------\n\nAll of the APIs you purchased in your\n[Google Cloud console](https://console.cloud.google.com/project/_/google/maps-apis/credentials?utm_source=Docs_Credentials)\nproject are enabled.\nTo access your APIs, sign in with your\n[Google Account](/maps/premium/devconsole_access), and then select your\nproject ID, which starts with **Google Maps APIs for Business or Google Maps for Work or Google Maps**.\nBoth your account and project ID are in your welcome letter.\n\nAuthentication and authorization\n--------------------------------\n\nTo make requests to our APIs, you must authenticate your application with either\nan API key or your client ID. In addition, requests for some APIs also require\ndigital signatures.\n\n### API key\n\nYou can use an API key to authenticate requests to any of our APIs. To create\nyour key, you'll use the Cloud console project associated with\nyour project ID. By using an API key, you can:\n\n- Manage all of your APIs in the Cloud console\n\n- Access real-time usage data and 30-days of historical usage data for your\n application in the Cloud console Google Maps Platform\n Metrics\n\n### Client ID\n\nInstead of an API key, you can use your client ID to make requests to any of the\nAPIs *except* the following: Places API,\nGeolocation API, Roads API,\nMaps SDK for Android, and Maps SDK for iOS.\n\nWith your client ID, you can:\n\n- Manage your Client ID and access your private *URL signing secret*,\n or cryptographic key, in the Cloud console.\n\n- Access real-time usage data and 30-days of historical usage data for your\n application from the\n [Cloud console Metrics](https://console.cloud.google.com/google/maps-apis/metrics) page.\n\n For a client ID, a label of the following format will be used:\n `project_number:\u003cYOUR_PROJECT_NUMBER\u003e`.\n- Add the `channel` parameter to requests so you can view more detailed usage\n reports.\n\n#### Where to manage your Client ID in the Google Cloud console\n\nThe Premium Plan Client ID management functionality is available\nin the\n[Cloud console](https://console.cloud.google.com/project/_/google/maps-apis/credentials?utm_source=Docs_Credentials) at the bottom of the\nGoogle Maps Platform Credentials page, in the **Client ID** section. \n\nFurther client ID management tasks, including URL authorization and client ID signing secret\nmanagement, can be accessed on the separate\n[Client ID page](https://console.cloud.google.com/project/_/google/maps-apis/clientid), by clicking the\nedit **edit** icon at the far right of the\n**Client ID** section.\n\n### Digital signatures\n\nIn addition to an API key or client ID, requests to some APIs also require a\nunique digital signature to access the quota and features of your\nPremium Plan. You can generate digital signatures using the private\n*URL signing secret*, or cryptographic key, provided in your Welcome letter\n(and available in the Cloud console). Specifically, you'll need\nto use digital signatures if you use:\n\n- **A client ID** with the web service APIs,\n Maps Static API, or\n Street View Static API\n\n- **An API key** with the Maps Static API or\n Street View Static API\n\n### For more information\n\nFor detailed instructions on using an API key or client ID, and generating\ndigital signatures, see the\n[Premium Plan Authentication Overview](/maps/premium/authentication/overview).\n\nFAQs\n----\n\nIf you have questions about Google Maps Platform, see our frequently asked\nquestions (FAQs):\n\n- [General FAQ](/maps/faq)\n- [Premium Plan FAQ](/maps/premium/faq)\n\nGetting help\n------------\n\nAs a Google Maps Platform Premium Plan customer, you can access the\nCloud console, where you can find support contact information and\naccess exclusive tools and resources. For details, see\n[Google Maps Platform Support and Resources](/maps/support)."]]
