الأسئلة الشائعة حول "منصة خرائط Google"

البدء

فهم بنود الخدمة

حدود الاستخدام والفوترة

استخدام "منصة خرائط Google"

الأخطاء وتحديد المشاكل وحلّها

خدمات "منصة خرائط Google"

Maps JavaScript API

حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS

حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android

توقيع عنوان URL

البدء

ما هي "منصة خرائط Google"؟

"منصّة خرائط Google" هي مجموعة من واجهات برمجة التطبيقات وحِزم تطوير البرامج (SDK) التي تسمح للمطوّرين بتضمين "خرائط Google" في التطبيقات المتوافقة مع الأجهزة الجوّالة وصفحات الويب، أو لاسترداد البيانات من "خرائط Google". هناك العديد من العروض. استنادًا إلى احتياجاتك، قد تستخدم واحدة أو مجموعة من واجهات برمجة التطبيقات ومجموعات تطوير البرامج (SDK) التالية:

"خرائط Google":

المسارات:

الأماكن:

البيئة:

كيف يمكنني البدء في استخدام "منصة خرائط Google"؟

اطّلِع على بدء استخدام "منصة خرائط Google".

ما هي واجهة برمجة التطبيقات التي أحتاج إليها؟

للحصول على مساعدة في العثور على واجهة برمجة التطبيقات المناسبة استنادًا إلى متطلباتك الوظيفية، يمكنك الاطّلاع على أداة اختيار واجهات برمجة التطبيقات.

كيف يمكنني بدء استخدام واجهات برمجة التطبيقات على موقعي الإلكتروني؟

اطّلِع على أدلة "نظرة عامة" و"المطوّر" و"البدء" لواجهة برمجة التطبيقات أو حزمة تطوير البرامج المحدّدة التي تهمّك. على سبيل المثال، يمكنك الاطّلاع على الأدلة المتعلّقة بحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android أو واجهة برمجة تطبيقات JavaScript لخرائط Google.

ما هي البلدان التي توفّر فيها "منصة خرائط Google"؟

يعمل فريق "خرائط Google" باستمرار على طرح بيانات جديدة للخريطة وزيادة نطاق توفّرها على مستوى العالم. يمكنك الرجوع إلى بيانات تغطية "خرائط Google" للاطّلاع على أحدث المعلومات حول التغطية. يمكنك فلترة البيانات باستخدام مربّع الفلتر في أعلى الصفحة. يُرجى العِلم أنّ بيانات التغطية يمكن أن تتغيّر في حال تغيّر اتفاقيات الترخيص مع مزوّدي البيانات.

اطّلِع أيضًا على:

هل يمكنني عرض "خرائط Google" على موقعي الإلكتروني بدون استخدام منتجات "منصة خرائط Google"؟

نعم. تتيح لك خرائط Google الآن تضمين الخريطة التي تطّلع عليها في موقعك الإلكتروني أو مدونتك، بدون أيّ برمجة أو استخدام "منصّة خرائط Google". يمكنك الاطّلاع على مزيد من المعلومات هنا.

كيف يمكنني إرسال تطبيقات "خرائط Google" على الأجهزة الجوّالة؟

لدمج الخرائط في تطبيق Android، استخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android.

لدمج الخرائط في تطبيق أصلي لنظام التشغيل iOS، استخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS.

تم تطوير Maps JavaScript API لتلبية احتياجات الأجهزة الجوّالة، وهي مناسبة لتطبيقات المتصفّحات التي تستهدف كلّ من أجهزة الكمبيوتر المكتبي والأجهزة التي تتضمّن متصفّح ويب مع تنفيذ كامل لـ JavaScript، مثل هواتف Apple iPhone.

بالنسبة إلى التطبيقات التي تستهدف الأجهزة غير المناسبة لاستخدام واجهة برمجة التطبيقات Maps JavaScript API، توفّر Maps Static API صور الخرائط بتنسيقات GIF وJPG وPNG، بما في ذلك العلامات والخطوط المتعددة. يُرجى العِلم أنّ استخدام واجهة برمجة التطبيقات Maps Static API خارج التطبيقات المبنية على المتصفّح يتطلّب ربط صورة الخريطة بخرائط Google.

ما هي متصفّحات الويب التي تتوافق مع واجهتَي برمجة التطبيقات JavaScript لخرائط Google و Maps Embed API؟

تتوافق واجهتا برمجة التطبيقات Maps JavaScript API وMaps Embed API مع متصفّحات الويب التالية:

أجهزة الكمبيوتر المكتبي
  • الإصدار الحالي من Microsoft Edge (لنظام التشغيل Windows)، باستثناء وضع IE
  • أحدث إصدارَين رئيسيَّين ثابتَين من Firefox (لنظام التشغيل Windows وmacOS وLinux)
  • آخر إصدارَين رئيسيَّين ثابتَين من Chrome (لنظام التشغيل Windows وmacOS وLinux)
  • أحدث إصدارَين رئيسيَّين ثابتَين من Safari (نظام التشغيل macOS)
Android
  • الإصدار الحالي من Chrome على الإصدار 4.1 من نظام التشغيل Android والإصدارات الأحدث
  • ‏Chrome WebView على الإصدار 4.4 من نظام التشغيل Android والإصدارات الأحدث
iOS
  • متصفّح Safari للأجهزة الجوّالة على الإصدارات الرئيسية الحالية والسابقة من نظام التشغيل iOS
  • ‫UIWebView وWKWebView على الإصدارات الرئيسية الحالية والسابقة من نظام التشغيل iOS
  • الإصدار الحالي من Chrome لأجهزة iOS
هل يمكنني طباعة الخرائط من واجهة برمجة التطبيقات Maps JavaScript API؟

لا تتوفّر إمكانية الطباعة من واجهة برمجة التطبيقات JavaScript خرائط Google. ويرجع ذلك إلى أنّ ميزة الطباعة غير متاحة في بعض المتصفحات الشائعة الاستخدام.

كيف يمكنني تلقّي إشعارات عند إجراء تغييرات على منتجات Google Maps Platform؟

عليك الاشتراك في مدونة Google Maps Platform للحصول على آخر الأخبار حول عروض Google Geo المختلفة للمطوّرين.

كيف يمكنني التواصل مع فريق الدعم الفني؟

اطّلِع على موارد ودعم "منصة خرائط Google" للحصول على معلومات عن خيارات الدعم المتاحة.

متى يتوفّر الدعم الفني؟
يتوفّر فريق الدعم على مدار 24 ساعة طوال أيام الأسبوع (من الاثنين الساعة 9 صباحًا بتوقيت طوكيو إلى الجمعة الساعة 5 مساءً بتوقيت المحيط الهادئ) باستثناء العطلات الإقليمية لحلّ المشاكل المتعلّقة بـ "تعذُّر استخدام الخدمة".
كيف يمكنني استرداد إمكانية الوصول إلى حسابي على Google؟

إذا لم تعُد قادرًا على الوصول إلى حسابك على Google (مثل joe@mycompany.com أو joe@gmail.com)، يمكنك محاولة استعادة إمكانية الوصول إلى الحساب من خلال استرداد كلمة المرور أو إعادة ضبطها. يُرجى الانتقال إلى مقالة كيفية استرداد حسابك على Google أو Gmail في مساعدة حساب Google.

كيف يمكنني استعادة إمكانية الوصول إلى مشروع معيّن؟

إذا فقدت إمكانية الوصول إلى المشروع الذي تدير فيه عملية تنفيذ "منصة خرائط Google"، يمكنك محاولة استرداده.

إذا كان بإمكانك الوصول إلى حسابك على Google المرتبط بالمشروع:

إذا لم يكن بإمكانك الوصول إلى حسابك على Google المرتبط بمشروعك:

هل يمكنني استخدام حزمة تطوير البرامج (SDK) لتطبيقَي "خرائط Google" و"الأماكن" لنظام التشغيل iOS على أجهزة Mac المستندة إلى معالجات Arm؟

يمكن إجراء عملية التطوير على أجهزة Mac الجديدة المستندة إلى Arm، ولكن يتطلّب ذلك إنشاء التطبيق وتشغيله على جهاز iOS. هذا قيد مؤقت بينما ننظر في إضافة المزيد من الدعم لميزة تطوير التطبيقات على أجهزة المحاكاة.

فهم بنود الخدمة

ما هي بنود خدمة منتجات "منصة خرائط Google"؟

يمكنك الاطّلاع على بنود خدمة Google Maps Platform على الرابط التالي:

https://cloud.google.com/maps-platform/terms

هل يستوفي موقعي الإلكتروني بنود خدمة Google Maps Platform؟

يمكنك استخدام Google Maps Platform في تطبيقاتك ما دام موقعك الإلكتروني يستوفي بنود خدمة Google Maps Platform.

ومع ذلك، هناك بعض الاستخدامات لمنصّة "خرائط Google" التي لا نريد رؤيتها: على سبيل المثال، الخرائط التي تحدّد أماكن شراء الأدوية المحظورة في مدينة معيّنة أو أي نشاط غير قانوني آخر. نحن نحترم أيضًا خصوصية المستخدمين، لذا يجب عدم استخدام "منصّة خرائط Google" لتحديد المعلومات الخاصة عن الأفراد.

عليك الاستعانة بمستشارك الخاص لتحديد ما إذا كان تطبيقك يمتثل لبنود خدمة "منصّة خرائط Google" قبل تطويره وإطلاقه. يمكن لمهندسي Google تقديم المساعدة الفنية فقط وهم ليسوا مؤهَّلين لتقديم مشورة قانونية. تحتفظ Google بالحق في تعليق استخدامك للخدمة أو إنهائه في أي وقت، لذا يُرجى قراءة بنود واجهات برمجة التطبيقات في "خرائط Google" بعناية.

هل يمكنني الوصول مباشرةً إلى شرائح الخريطة وصور الأقمار الصناعية؟

لا يجوز لك الوصول إلى شرائح الخريطة أو صور الأقمار الصناعية من خلال أي آلية أخرى غير "منصّة خرائط Google" (مثل إنشاء واجهة برمجة تطبيقات خاصة بعمليات الربط أو استخدام نص برمجي لتنزيل شرائح الخريطة بشكل مجمّع). سيتم منع تطبيقك من الوصول إلى المربّعات إذا كان يصل إليها خارج "منصّة خرائط Google". يُرجى الاطّلاع على بنود خدمة Google Maps Platform لمعرفة المزيد من التفاصيل.

هل يمكنني استخدام منتجات "منصّة خرائط Google" لتتبُّع التطبيقات؟

لا يوجد أي قيود على عرض البيانات في الوقت الفعلي (التتبّع) باستخدام منتجات Google Maps Platform شرط أن يمتثل التطبيق لبنود خدمة Google Maps Platform.

هل يمكنني استخدام "خرائط Google" في تطبيقي غير المتوافق مع الويب؟

نعم، يمكن الآن استخدام منتجات "منصة خرائط Google" في تطبيقات غير تطبيقات الويب، شرط أن تكون متوافقة مع القيود الأخرى الواردة في بنود خدمة "منصة خرائط Google".

لا تتوفّر واجهة برمجة التطبيقات JavaScript لـ "خرائط Google" إلا عند تشغيلها فيأحد المتصفّحات المتوافقة.

هل يمكنني استخدام منتجات "منصة خرائط Google" على موقع إلكتروني محمي بكلمة مرور؟

نعم، يمكن استخدام "خرائط Google" و"المسارات" و"الأماكن" و"خدمات البيئة" مع تطبيقات الوصول الخاص. يُرجى الاطّلاع على بنود خدمة Google Maps Platform لمعرفة المزيد من التفاصيل.

هل يمكنني إنشاء تطبيق يتضمّن بيانات "منصّة خرائط Google" في مستند؟

إذا كان تطبيقك ينشئ مستندًا، سواءً كان في شكل إلكتروني أو مطبوع، لا يجوز تضمين أي بيانات من "منصّة خرائط Google"، بما في ذلك الصور، في المستند. يُرجى الاطّلاع على بنود خدمة "منصة خرائط Google" قسم "عدم استخدام برامج جمع البيانات" للحصول على مزيد من التفاصيل.

كيف يمكنني إيقاف تضمين المحتوى الخاص بي في نتائج بحث Google؟

لم نعُد نجمع هذه البيانات. تم إيقاف استخدام المَعلمة indexing نهائيًا ولن يكون لها أي تأثير. لم تعُد بحاجة إلى إيقاف هذه الميزة بشكل صريح، ولكننا ننصحك بإزالة هذه المَعلمة في أقرب وقت ممكن مناسب لك.

لإزالة صفحتك أو موقعك الإلكتروني من نتائج البحث، اتّبِع التعليمات الواردة في مركز مساعدة مشرفي المواقع.

هل يمكنني إنشاء صورة خريطة باستخدام واجهة برمجة التطبيقات Maps Static API التي أحفظها وأعرضها من موقعي الإلكتروني؟

لا يجوز لك تخزين نُسخ من الصور التي تم إنشاؤها باستخدام واجهة برمجة التطبيقات Maps Static API من موقعك الإلكتروني وعرضها. يجب أن تربط جميع صفحات الويب التي تتطلّب صورًا ثابتة سمة src لعلامة HTML img أو سمة background-image لملف CSS لعلامة HTML div مباشرةً بواجهة برمجة التطبيقات "الثابتة في خرائط Google" لكي تتمكّن Google من عرض جميع صور الخرائط ضمن محتوى HTML لصفحة الويب و عرضها مباشرةً للمستخدمين النهائيين.

حدود الاستخدام والفوترة

كيف يمكنني إعداد الفوترة لمشروعي؟
اطّلِع على بدء استخدام "منصة خرائط Google".
كيف يمكن لعملاء Google Cloud Platform في "الإصدار المجاني" الترقية إلى حساب مدفوع؟
يقدّم برنامج الإصدار المجاني من Google Cloud Platform للعملاء فترة تجريبية بدون أي رسوم مع رصيد بقيمة 300 دولار أمريكي لاستخدامه مع أي خدمة من خدمات Google Cloud، بما في ذلك واجهات برمجة تطبيقات Google Maps Platform. عند انتهاء الفترة التجريبية المتاحة بدون رسوم، عليك الترقية إلى حساب مدفوع لمواصلة استخدام هذه الخدمات. للترقية إلى حساب مدفوع، يُرجى الانتقال إلى وحدة تحكّم Cloud.
هل هناك حدود لاستخدام "منصة خرائط Google"؟

ما مِن حدود قصوى يومية لعدد الطلبات التي يمكنك إجراؤها على منتجات Google Maps Platform، وحدود الاستخدام الوحيدة مرتبطة بمحاولة الحد الأقصى لعدد طلبات البحث في الدقيقة (QPM).

بالنسبة إلى "جدول المسافات"، يتم ضبط الحدّ الأقصى للأحداث في الدقيقة (EPM) ويتم احتسابه على أنّه مجموع طلبات البحث من جهة العميل والخادم.

بالنسبة إلى "المسارات:احتساب مصفوفة المسارات"، يكون الحدّ الأقصى للعناصر في الدقيقة (EPM)، حيث يكون عدد العناصر في الطلب مساويًا: (عدد نقاط المصدر مضروبًا في عدد نقاط الوجهة).

بالنسبة إلى حِزم تطوير البرامج (SDK) لنظام التنقّل، يتم احتساب كل وجهة في طلب كطلب بحث منفصل.

يعرض الجدول التالي الحد الأقصى لاستخدام كل واجهة برمجة تطبيقات.

واجهة برمجة التطبيقات الحد الأقصى المسموح به للاستخدام
Address Validation 6,000 ملف برمجي في الساعة
Aerial View: Lookup Video 180 طلب بحث في الدقيقة و100,000 طلب بحث في اليوم
عرض جوي: إنشاء فيديو 100 طلب في الدقيقة و100 طلب في اليوم
جودة الهواء 6,000 ملف برمجي في الساعة
الاتجاهات 3,000 طلب في الدقيقة
Distance Matrix 60,000 EPM
الخرائط الديناميكية 30,000 كيلوبايت في الثانية
الارتفاع 6,000 ملف برمجي في الساعة
الترميز الجغرافي 3,000 طلب في الدقيقة
الموقع الجغرافي 6,000 ملف برمجي في الساعة
Map Tiles API: مربّعات ثنائية الأبعاد ومربّعات "التجوّل الافتراضي" 6,000 طلب بحث في الدقيقة و15,000 طلب بحث في اليوم
Map Tiles API: مربّعات ثلاثية الأبعاد لصور واقعية 10,000 طلب بحث في الثانية
Map Tiles API: Photorealistic 3D Tiles: Renderer 12,000 ملف في الساعة
التنقّل: ضبط طلبات الوجهة 30,000 ملف تعريف بريد إلكتروني سنويًا
الأماكن 6,000 ملف برمجي في الساعة
لقَاح 6,000 ملف برمجي في الساعة
الطرق 30,000 ملف تعريف بريد إلكتروني سنويًا
المسارات: حساب المسارات 3,000 طلب في الدقيقة
المسارات: احتساب مصفوفة المسارات 3,000 EPM
الطاقة الشمسية 600 كيلو بايت في الثانية
الخرائط الثابتة 30,000 ملف تعريف بريد إلكتروني سنويًا
واجهة برمجة تطبيقات صور التجوّل الافتراضي 30,000 ملف تعريف بريد إلكتروني سنويًا
المنطقة الزمنية 30,000 ملف تعريف بريد إلكتروني سنويًا

لإدارة الإنفاق، يمكنك مراقبة استخدام واجهة برمجة التطبيقات، وضبط حدود يومية لجميع الطلبات المرسَلة إلى أي واجهة برمجة تطبيقات تخضع للفوترة.

يجب نشر منتجات Google Maps Platform بما يتوافق مع بنود خدمة Google Maps Platform العادية.

كيف يتم احتساب تكلفة الاستخدام؟

للحصول على نظرة عامة على أسعار منتجات Google Maps Platform، يُرجى الاطّلاع على جدول الأسعار.

للاطّلاع على مزيد من المعلومات عن كيفية فوترة واجهات برمجة التطبيقات في "منصة خرائط Google"، يُرجى الاطّلاع على مقالة التعرّف على الفوترة في واجهتَي برمجة التطبيقات Maps وRoutes وPlaces وEnvironment.

كيف يتم احتساب عمليات تحميل الخرائط على "منصّة خرائط Google"؟

يتم تحصيل رسوم تحميل خريطة واحدة عند حدوث أيّ مما يلي:

  • تعرض صفحة ويب أو تطبيق خريطة باستخدام واجهة برمجة التطبيقات Maps JavaScript API.
  • يطلب أحد التطبيقات صورة خريطة واحدة من واجهة برمجة التطبيقات "خرائط Google" الثابتة.

يتم تحصيل رسوم بانوراما "التجوّل الافتراضي" بشكل منفصل عن عمليات تحميل الخرائط:

  • يتم تحصيل رسوم مقابل بانوراما ثابتة في "التجوّل الافتراضي" مقابل كل طلب إلى واجهة برمجة التطبيقات لبانوراما "التجوّل الافتراضي" الثابتة بغرض تضمين بانوراما ثابتة (غير تفاعلية) في "التجوّل الافتراضي".
  • يتم تحصيل رسوم مقابل بانوراما "التجوّل الافتراضي" الديناميكية لكلّ عملية إنشاء لعنصر بانوراما في واجهة برمجة تطبيقات JavaScript للخرائط أو حزمة تطوير البرامج (SDK) لتطبيقات "خرائط Google" لنظام Android أو حزمة تطوير البرامج (SDK) لتطبيقات "خرائط Google" لنظام iOS.

بعد أن تحمِّل صفحة ويب أو تطبيق خريطة أو صورة خريطة ثابتة أو صورة بانورامية في "التجوّل الافتراضي"، لا تؤدي أي تفاعلات للمستخدِم مع الخريطة، مثل التمرير أو التكبير أو التصغير أو تبديل طبقات الخريطة، إلى توليد عمليات تحميل إضافية للخريطة أو التأثير في حدود الاستخدام.

لن تؤدي إضافة علامة إلى تحميل خرائط إضافية، ولكن قد تؤدي إلى تحصيل رسوم مقابل كيفية تحديد موقع الدبوس (مثل تحميل فئة google.maps.Map()‎ أو إعادة تحميلها).

كيف يمكنني مراقبة معدّل الاستخدام؟

يمكنك مراقبة استخدام واجهات برمجة تطبيقات فردية في وحدة تحكّم Google Cloud.

  1. اختَر المشروع الذي يحتوي على واجهة برمجة التطبيقات التي تريد مراجعتها.
  2. من قائمة واجهات برمجة التطبيقات في لوحة البيانات، انقر على اسم واجهة برمجة التطبيقات.
  3. بالقرب من أعلى الصفحة، انقر على المقاييس أو الحصص.

للاطّلاع على تقرير عن عدد الزيارات ومعلومات الفوترة لمشروع كامل، اتّبِع الخطوات التالية:

  1. إعداد الفوترة إذا لم يسبق لك ذلك
  2. انتقِل إلى صفحة الفوترة في Cloud Console.
  3. اختَر مشروعًا.
  4. في الشريط الجانبي الأيمن، انقر على التقارير. استخدِم الفلاتر في الشريط الجانبي الأيمن لعرض التقارير في حساب الفوترة.

للاطّلاع على مزيد من المعلومات، يمكنك الاطّلاع على تقارير "منصّة خرائط Google" بالإضافة إلى مراقبة استخدام واجهة برمجة التطبيقات ووضع حدود لاستخدام واجهة برمجة التطبيقات.

ماذا يحدث إذا تجاوزت حدود معدّل الطلبات (الطلبات في الدقيقة)؟

في حال تجاوز حدود عدد عمليات البحث في الصفحة لمنتج معيّن في "منصّة خرائط Google"، ستعرض واجهة برمجة التطبيقات رسالة خطأ. إذا تجاوزت الحدود القصوى بشكل متكرّر، قد يتم حظر وصولك إلى واجهة برمجة التطبيقات مؤقتًا.

في حال تجاوز حدود عدد طلبات البحث في الدقيقة أو إساءة استخدام الخدمة بأي شكل آخر، ستعرض الطلبات رسالة خطأ محدّدة. إذا استمرت في تجاوز الحدود، قد يتم حظر إمكانية وصولك إلى "منصة خرائط Google".

ملاحظة: تتوفّر خدمة مماثلة من جهة العميل في Maps JavaScript API لأربع واجهات برمجة تطبيقات لخدمة الويب: الاتجاهات وDistance Matrix وElevation وGeocoding.

تم تجاوز حدود الاستخدام

في حال تجاوزت حدود الاستخدام، ستتلقّى OVER_QUERY_LIMIT رمز حالة كردّ.

تعني هذه الرسالة أنّ خدمة الويب توقّفت عن تقديم الردود العادية وانتقلت إلى عرض رمز الحالة OVER_QUERY_LIMIT فقط إلى أن يُسمح بمزيد من الاستخدام مرة أخرى. يمكن أن يحدث هذا السيناريو خلال بضع ثوانٍ، إذا تم تلقّي الخطأ لأنّ تطبيقك أرسل عددًا كبيرًا جدًا من الطلبات في الدقيقة.

إذا كنت تتجاوز الحدود القصوى لاستخدام طلبات البحث في خرائط Google بشكل منتظم، ننصحك بخفض معدّل الاستخدام من خلال تحسين التطبيقات لاستخدام منتجات "منصّة خرائط Google" بفعالية أكبر، أو طلب زيادة حصتك. اطّلِع على دليل التحسين لمزيد من المعلومات.

يتلقّى موقعي الإلكتروني عددًا كبيرًا من الزيارات. هل يمكنني استخدام منتجات "منصة خرائط Google"؟

نعم. ومع ذلك، ننصحك بالاطّلاع على حدود الاستخدام لأي من ميزات "منصّة خرائط Google" التي يعتمد عليها تطبيقك.

بعد أن يكون لديك حساب فوترة، إذا تجاوزت حد الاستخدام الشهري بدون رسوم والذي يبلغ 200 دولار أمريكي ولم يكن لديك طريقة دفع صالحة في حساب الفوترة (بطاقة الائتمان أو التحويل المصرفي أو غير ذلك)، سيتوقّف واجهة برمجة التطبيقات عن العمل إلى أن تضيف طريقة دفع صالحة.

كيف سيتم احتساب الاستخدام وإصدار الفواتير؟

يتم احتساب الاستخدام في نهاية كل يوم، ويتم تحديد سعره كما هو موضّح في جدول الأسعار. في نهاية كل شهر، يتم تحصيل إجمالي رسوم الاستخدام من طريقة الدفع المرتبطة بحساب الفوترة. لمزيد من المعلومات، يُرجى الاطّلاع على الفوترة في Google Maps Platform.

ما هي تكلفة استخدام "منصة خرائط Google"؟

اطّلِع على جدول الأسعار للحصول على نظرة عامة على التكلفة لكل واجهة برمجة تطبيقات. إذا كان تطبيقك يُنشئ طلبات أو أحجام تحميل خرائط تصل إلى 200 دولار أمريكي في الشهر ، لن يتم تحصيل رسوم منك مقابل استخدامك. سيتم تحصيل الرسوم من حساب الفوترة مقابل الاستخدام الذي يتجاوز الرصيد الشهري الذي تبلغ قيمته 200 دولار أمريكي. لمزيد من التفاصيل، يُرجى الاطّلاع على دليل فهم الفوترة في Google Maps Platform.

هل تتوفّر الأسعار بعملات أخرى؟

عملات إضافية قد تكون متاحة في وحدة التحكّم. عند اختيار عملة مختلفة، سيتم تحويل الأسعار من القيمة المعادلة بالدولار الأمريكي والمدرَجة في جدول الأسعار.

لقد أعددت الفوترة. كيف يمكنني الاطّلاع على فاتورتي؟

تحصّل Google منك الرسوم في بداية كل شهر مقابل النشاط الذي تمّ في الشهر السابق، وذلك باستخدام طريقة الدفع المحدّدة. للاطّلاع على تفاصيل عن فاتورتك، يُرجى الاطّلاع على دليل فهم الفوترة في "منصّة خرائط Google".

معلومات إضافية:

كيف أتجنب دفع فاتورة كبيرة في حالة زيادة استخدامي بشكل غير متوقع؟

توفّر "منصّة خرائط Google" طرقًا لضبط حدود الطلبات اليومية وتحديد الحد الأقصى للحدود اليومية القابلة للفوترة. يمكنك تحديد الحد الأقصى اليومي للاستخدام بهدف الحماية من الزيادات غير المتوقّعة. يمكنك أيضًا ضبط تنبيهات بشأن الميزانية لتلقّي إشعارات عبر البريد الإلكتروني عند بلوغ الرسوم في حساب الفوترة الحدّ الذي تحدّده.

وضع حد أقصى للمبلغ اليومي الذي يمكن إصدار فاتورة به:

لتجنُّب تلقّي فاتورة كبيرة، يمكنك ضبط حدّ أقصى يومي للاستخدام للحماية من الارتفاعات غير المتوقّعة في الاستخدام. يمكنك تغيير هذا الحدّ في Cloud Console باتّباع الخطوات التالية:

  1. انتقِل إلى لوحة بيانات "واجهات برمجة التطبيقات والخدمات".
  2. اختَر مشروعًا إذا طُلب منك ذلك.
  3. اختَر واجهة برمجة تطبيقات من القائمة، ثم انقر على علامة التبويب الحصص.
  4. انقر على رمز التعديل بجانب حصة "الطلبات في اليوم".

بدلاً من ذلك، يمكنك تعديل حصص متعددة لواجهات برمجة تطبيقات متعددة باستخدام لوحة بيانات "إدارة الهوية وإمكانية الوصول والحصص".

ضبط تنبيهات الميزانية وإدارتها:

إعداد تنبيهات بشأن الميزانية لإرسال إشعارات عبر البريد الإلكتروني إلى مشرفي الفوترة عندما تبلغ الرسوم في حساب الفوترة الحدّ الذي تحدّده سيتلقّى مشرفي الفوترة إشعارات عبر البريد الإلكتروني عندما تتجاوز الرسوم المقدَّرة في حساب الفوترة نسبة %50 و%90 و% 100 من الحدّ الأقصى.

لقد تلقّيتُ رسالة تفيد بأنّ مشروعي مرتبط بـ "حساب النقل في منصة خرائط Google"، ولكن لا يمكنني الوصول إلى هذا الحساب. فماذا أفعل؟

تم إنشاء "حساب النقل إلى منصة خرائط Google" لمساعدة بعض العملاء على الانتقال إلى خطة الأسعار الجديدة "الدفع حسب الاستخدام". من خلال هذا الإجراء، تمكّنت Google من منح هؤلاء العملاء رصيدًا لمرة واحدة، وبالتالي تمكّنوا من مواصلة استخدام "منصة خرائط Google" بما يصل إلى الحد الأقصى لمستوى الاستخدام بدون رسوم الذي يبلغ 200 دولار أمريكي. وبعد تجاوز هذا الحدّ، سيتم إغلاق حساب الفوترة وستفقد إمكانية الوصول إلى الخدمة. لتجنُّب انقطاع الخدمة، نحثك على إعداد حساب الفوترة الخاص بك ومواصلة الاستفادة من المستوى المجاني الذي تبلغ قيمته 200 دولار أمريكي شهريًا. لتغيير حساب الفوترة لمشروعك:

  1. إنشاء حساب فوترة جديد (إذا كان لديك حساب فوترة، يمكنك تخطّي هذه الخطوة).
  2. اربط حساب الفوترة بمشروعك.
لماذا تم ضبط الحد الأقصى للحصة على طلب واحد في اليوم؟ كيف يمكنني رفع هذا الحدّ؟

إذا لم تنشئ حساب فوترة وتُرفقه بمشروعك، سيتم تقييد واجهات برمجة التطبيقات في "منصّة خرائط Google" بطلب واحد في اليوم. يمكنك الحصول على حصة أكبر من خلال إنشاء حساب فوترة وإرفاقه. لإجراء ذلك، يُرجى الاطّلاع على مقالة بدء استخدام "منصة خرائط Google".

بعد إنشاء حساب فوترة وإرفاقه، سيتم إزالة الحد الأقصى لحصتك اليومية. يمكنك ضبط قيد لمنع الإنفاق غير المتوقّع في وحدة تحكّم Cloud.

تلقّيتُ إشعارًا بمخالفة في الفوترة. كيف يمكنني حلّ هذه المشكلة؟

لقد تلقّيت هذا الإشعار لأنّ Google تبيّن لها أنّ حسابك يستخدم حسابات فوترة متعدّدة. يشكّل ذلك انتهاكًا لبنود Google، على النحو المحدّد في الفقرة 3.2.4 من بنود خدمة "منصّة خرائط Google". بموجب هذه الأحكام، يُحظر إنشاء حسابات فوترة متعددة. لمزيد من المعلومات، يُرجى الاطّلاع على الأسئلة الشائعة حول الفوترة انتهاك الحساب.

استخدام "منصة خرائط Google"

ما هي المفاتيح أو بيانات الاعتماد التي يجب استخدامها لمنتجات "خرائط Google" المختلفة؟

في كل مرة تستخدم فيها منتجات Google Maps Platform، يجب تضمين مفتاح واجهة برمجة التطبيقات للتحقّق من طلبك. تتوفّر "منصّة خرائط Google" لتطبيقات Android أو iOS أو الويب، وعبر خدمات الويب HTTP.

مفتاح واجهة برمجة التطبيقات:

  • مفتاح واجهة برمجة التطبيقات هو معرّف فريد تنشئه باستخدام وحدة تحكّم Cloud.
  • مثال على تحميل واجهة برمجة تطبيقات باستخدام مفتاح: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

التوقيع الرقمي:

  • يتم إنشاء توقيع رقمي باستخدام مفتاح سري لتوقيع عناوين URL تقدّمه لك Google. يتم استخدام التوقيعات الرقمية مع واجهتَي برمجة التطبيقات Maps Static API و Street View Static API.

القيود:

يشير الجدول أدناه إلى المفتاح/المستندات المُعتمَدة وتطبيق القيود لكل من Google Maps Platform API/SDK.

واجهة برمجة التطبيقات/حزمة تطوير البرامج (SDK) قيود بيانات الاعتماد والتطبيقات
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android مفتاح واجهة برمجة التطبيقات مع تقييد Android1
حزمة تطوير برامج "الأماكن" لأجهزة Android مفتاح واجهة برمجة التطبيقات مع تقييد Android1
حزمة تطوير البرامج للتنقّل على أجهزة Android مفتاح واجهة برمجة التطبيقات مع تقييد Android1
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS مفتاح واجهة برمجة التطبيقات مع تقييد iOS1
حزمة تطوير برامج "الأماكن" لأجهزة iOS مفتاح واجهة برمجة التطبيقات مع تقييد iOS1
حزمة تطوير البرامج للتنقّل على أجهزة iOS مفتاح واجهة برمجة التطبيقات مع تقييد iOS1
Maps JavaScript API مفتاح واجهة برمجة التطبيقات مع تقييد المُحيل HTTP1
واجهة برمجة التطبيقات Map Tiles API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Maps Datasets API رمز OAuth المميّز
Aerial View API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Maps Static API مفتاح واجهة برمجة التطبيقات مع تقييد المُحيل HTTP1 + توقيع رقمي2
Street View Static API مفتاح واجهة برمجة التطبيقات مع تقييد المُحيل HTTP1 + التوقيع الرقمي2
Maps Embed API مفتاح واجهة برمجة التطبيقات مع تقييد المُحيل HTTP1
Address Validation API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Directions API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Distance Matrix API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Elevation API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Geocoding API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Geolocation API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Places API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Roads API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Routes API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Time Zone API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Air Quality API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Pollen API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Solar API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
1 القيود المفروضة على مفاتيح واجهة برمجة التطبيقات اختيارية، ولكننا ننصح بشدة بفرض قيود على جميع مفاتيح واجهة برمجة التطبيقات لتعزيز الأمان.
2 استنادًا إلى الاستخدام، قد يكون مطلوبًا استخدام توقيع رقمي في Maps Static API وStreet View Static API. بغض النظر عن طريقة الاستخدام، ننصحك بشدة باستخدام مفتاح واجهة برمجة التطبيقات وتوقيع رقمي لمصادقة طلباتك.
كيف يمكنني تبديل نوع القيود المفروضة على المفتاح من مُحيل HTTP إلى قيد عنوان IP؟

ملاحظة مهمة: إذا كنت تستخدم أيًا من واجهات برمجة تطبيقات خدمات الويب مع مفتاح واجهة برمجة تطبيقات يتضمّن قيودًا على المُحيل، ستتعذّر طلباتك وستظهر رسالة الخطأ: "لا يمكن أن تتضمّن مفاتيح واجهة برمجة التطبيقات قيودًا على المُحيل عند استخدامها مع واجهة برمجة التطبيقات هذه". عليك التبديل إلى استخدام مفتاح واجهة برمجة التطبيقات مع قيود عناوين IP.

قبل تبديل نوع القيود المفروضة على مفتاح واجهة برمجة التطبيقات من مُحيل HTTP إلى عنوان IP ، تأكَّد من أنّ جميع واجهات برمجة التطبيقات التي تستخدِم مفتاح واجهة برمجة التطبيقات تتيح نوع القيود المفروضة على عنوان IP. يمكن أن تستخدم واجهات برمجة التطبيقات من نوع القيود نفسه المفتاح المقيّد نفسه. إذا كنت بحاجة إلى فرض أكثر من قيد واحد، أضِف مفتاحًا منفصلاً بالقيد المطلوب. اطّلِع على كيفية إضافة ملف تعريف برمجة تطبيقات جديد.

مزيد من المعلومات عن القيود المفروضة على مفاتيح واجهة برمجة التطبيقات المرتبطة بمنتجات Google Maps Platform

لتبديل مفتاح واجهة برمجة تطبيقات مع تقييد المُحيل HTTP إلى تقييد عنوان IP، اتّبِع الخطوات التالية:

  1. انتقِل إلى صفحة بيانات الاعتماد في وحدة تحكّم Cloud.
  2. اختَر المشروع الذي يحتوي على مفتاح واجهة برمجة التطبيقات الذي تريد تعديله.
  3. في صفحة بيانات الاعتماد، اختَر اسم مفتاح واجهة برمجة التطبيقات من قائمة مفاتيح واجهة برمجة التطبيقات لتعديل تفاصيل المفتاح.
  4. في قسم قيود المفاتيح في الصفحة، اختَر "عناوين IP (خوادم الويب ووظائف cron وغيرها)" وأدخِل عناوين IP المناسبة للخادم، ثم انقر على "حفظ".
كيف يمكنني الحصول على مفتاح واجهة برمجة تطبيقات جديد؟
اطّلِع على بدء استخدام "منصة خرائط Google".
كيف يمكنني العثور على التغييرات التي تم إدخالها في كل إصدار من واجهات برمجة تطبيقات "خرائط Google"؟

تتوفّر معلومات عن تغييرات الإصدارات في العديد من واجهات برمجة تطبيقات "خرائط Google" على الروابط التالية:

يمكنك أيضًا التحقّق من إصدار Google Maps Platform الذي تم فيه تسجيل خطأ معيّن وإصلاحه باستخدام أداة تتبُّع المشاكل في Google Maps Platform على الرابط التالي:

https://issuetracker.google.com/bookmark-groups/76561

كيف يمكنني تحميل واجهة برمجة التطبيقات في صفحة بشكل غير متزامن بعد تحميل الصفحة؟

ما عليك سوى تحديد مَعلمة ردّ الاتصال عند تحميل واجهة برمجة التطبيقات. يمكن العثور على مزيد من المعلومات وعينات الرموز البرمجية في فصل البدء من مستندات واجهة برمجة التطبيقات JavaScript API في "خرائط Google".

كيف يمكنني عرض منتجات "منصة خرائط Google" بلغة غير الإنجليزية؟

ستحاول واجهة برمجة التطبيقات تلقائيًا تحميل اللغة الأكثر ملاءمةً استنادًا إلى الموقع الجغرافي للمستخدمين أو إعدادات المتصفّح. تتيح لك بعض واجهات برمجة التطبيقات ضبط اللغة صراحةً عند تقديم طلب. يمكنك الاطّلاع على مزيد من المعلومات عن كيفية ضبط اللغة في مستندات كل واجهة برمجة تطبيقات:

اللغات المتاحة:

غالبًا ما تعدّل Google اللغات المتاحة. قد لا تكون هذه القائمة شاملة وتخضع للتغيير.

رمز اللغة اللغة رمز اللغة اللغة
af الأفريقانية ja اليابانية
sq الألبانية kn الكانادا
صباحًا الأمهرية kk الكازاخستانية
ar العربية كم الخميرية
hy الأرمينية ko الكورية
az أذربيجان ky القيرغيزية
eu الباسك lo اللاوية
be البيلاروسية lv اللاتفية
bn البنغالية lt الليتوانية
bs البوسنية mk المقدونية
bg البلغارية ms الملاوية‬
my البورمية ml المالايالامية
ca الكتالانية mr الماراثية
zh الصينية mn المنغولية
zh-CN الصينية (المبسطة) ne النيبالية
zh-HK الصينية (هونغ كونغ) لا النرويجية
zh-TW الصينية (التقليدية) pl البولندية
ساعة الكرواتية pt البرتغالية
cs التشيكية pt-BR البرتغالية (البرازيل)
da الدانمركية pt-PT برتغالي (البرتغال)
nl الهولندية pa البنجابية
en الإنجليزية ro الرومانية
en-AU الإنجليزية (الأسترالية) ru الروسية
en-GB الإنجليزية (بريطانيا العظمى) sr الصربية
et الإستونية si السنهالية
fa الفارسية sk السلوفاكية
fi الفنلندية sl السلوفينية
fil الفلبينية es الإسبانية
fr الفرنسية es-419 الإسبانية (أمريكا اللاتينية)
fr-CA الفرنسية (كندا) sw السواحيلية
gl الغليشيانية sv السويدية
ka الجورجية ta التاميلية
de الألمانية te التيلوغوية
el اليونانية th التايلاندية
gu الغوجاراتية tr التركية
iw العبرية uk الأوكرانية
hi الهندية ur الأوردية
hu الهنغارية uz الأوزبكية
هو الأيسلندية vi الفيتنامية
id الإندونيسية zu الزولو
it الإيطالية

يمكنك الاطّلاع على الشكل الذي ستظهر به الخريطة بأي من اللغات المدرَجة أعلاه في نموذج التطبيق هذا.

هل يمكن الوصول إلى Google Maps Platform عبر طبقة المقابس الآمنة (HTTPS)؟

يمكن الوصول إلى واجهة برمجة التطبيقات JavaScript لخرائط Google وواجهة برمجة التطبيقات الثابتة لخرائط Google وواجهات برمجة تطبيقات خدمات الويب عبر اتصالات آمنة (HTTPS). يُرجى الاطّلاع على مستندات واجهة برمجة التطبيقات المعنيّة للحصول على معلومات عن كيفية الوصول إلى واجهة برمجة التطبيقات عبر طبقة المقابس الآمنة (SSL).

يُرجى العِلم أنّ واجهة برمجة التطبيقات Maps Static API لا تتوافق مع عناوين URL المخصّصة للرموز التي تستخدم HTTPS، وسيتم عرض الرمز التلقائي.

كيف يمكنني الإبلاغ عن خلل أو طلب ميزة جديدة في "منصّة خرائط Google"؟

إذا واجهت سلوكًا تعتقد أنّه قد يكون خطأ، يُرجى أولاً الإبلاغ عنه في المنتدى ذي الصلة. سيسمح ذلك للمطوّرين الآخرين بالتحقق من الخطأ واستبعاد أي مشاكل محتملة في الرمز البرمجي.

إذا أردت طلب ميزة، يُرجى أيضًا طرحها أولاً في المنتدى ذي الصلة للتأكّد من أنّه ليس متوفّرًا حلّ يلبي متطلباتك.

بعد التأكّد من رصد خطأ جديد أو أنّه لا يمكن تلبية متطلباتك باستخدام الوظائف الحالية لمنتجات "منصّة خرائط Google"، يُرجى الإبلاغ عن الخطأ أو طلب الميزة باستخدام أداة تتبُّع المشاكل في "منصّة خرائط Google".

قبل إضافة خطأ أو طلب ميزة إلى أداة تتبُّع المشاكل، يُرجى التأكّد من أنّه لم يتمّ إضافة الخطأ أو الميزة المعنيّة من قبل. إذا تم حلّها، يمكنك وضع علامة على المشكلة للتعبير عن اهتمامك بها والحصول على إشعارات بشأن آخر الأخبار.

كيف تستخدِم واجهات برمجة التطبيقات في Google Maps Platform ملفات تعريف الارتباط الخاصة بالمواقع الإلكترونية؟

تستخدِم حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" المتوافقة مع Android وحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" المتوافقة مع iOS ملفات تعريف الارتباط بموجب سياسة خصوصية Google، مثل احتساب مستخدمي التطبيق النشطين يوميًا وخلال آخر 7 أيام ومنع إساءة استخدام الخدمة. لا تكون ملفات تعريف الارتباط هذه مرتبطة بأي حساب Google تم تسجيل الدخول إليه ولا يتم تسجيلها مع بقية المعلومات التي يتم جمعها من طلبات بيانات من واجهة برمجة التطبيقات.

لا يمكنني العثور على إجابة عن سؤالي. ما هي الجهة التي يمكنني التواصل معها؟

يشارك فريق علاقات المطوّرين في Google على Stack Overflow، وهو موقع إلكتروني للأسئلة والأجوبة يُعدّه المبرمجون بشكل تعاوني. وهو مكان رائع لطرح الأسئلة الفنية حول تطوير تطبيقات "خرائط Google" وصيانتها. يمكنك الاطّلاع على مزيد من المعلومات حول طرح الأسئلة على Stack Overflow في صفحة الدعم.

للحصول على أفضل النتائج عند طلب المساعدة، يُرجى مراعاة ما يلي:

  • البحث في المناقشات الحالية من المحتمل أنّ شخصًا آخر واجه مشكلة مشابهة وعثر على حلّ لها.
  • أرسِل رابطًا إلى موقعك الإلكتروني إن أمكن. لا تنشر مقتطفات الرموز البريدية إلا إذا كان الرمز غير مرئي بسهولة على الإنترنت.
  • يُرجى تقديم جميع المعلومات ذات الصلة، بما في ذلك إصدارات المتصفّح والأخطاء وكلّ الحقائق الأخرى التي قد تكون مفيدة في تحديد هذه المشكلة وحلّها.

الأخطاء وتحديد المشاكل وحلّها

ما هو معنى هذا الخطأ؟

إذا واجهت خطأ أثناء تحميل واجهات برمجة تطبيقات "خرائط Google" أو تشغيلها، يُرجى الاطّلاع على الروابط التالية للعثور على تفسيرات لرموز الخطأ:

تظهر خرائطي أغمق من المعتاد. ماذا يحدث؟

في ظروف معيّنة، قد يتم عرض خريطة مظلمة أو صورة "سلبية" من "التجوّل الافتراضي"، مُعلَمَة بعلامة مائية تتضمّن النص "لأغراض التطوير فقط". يشير هذا السلوك عادةً إلى مشاكل في مفتاح واجهة برمجة التطبيقات أو الفوترة. لاستخدام منتجات Google Maps Platform، يجب أن يكون لديك حساب فوترة وأن تتضمّن جميع الطلبات مفتاح واجهة برمجة تطبيقات صالحًا. ستساعدك الخطوات التالية في تحديد المشاكل وحلّها:


كيف يمكنني حلّ رموز الخطأ: OVER_DAILY_LIMIT أو OVER_QUERY_LIMIT؟
يمكن عرض رموز الخطأ هذه لأيٍّ من الأسباب التالية:
  • لا يتضمّن الطلب مفتاح واجهة برمجة التطبيقات.
  • مفتاح واجهة برمجة التطبيقات المقدَّم غير صالح.
  • لا يتضمّن المشروع حساب فوترة مرفقًا.
  • تم تجاوز الحد الأقصى للاستخدام الذي فرضته على نفسك.
  • لم تعُد طريقة الدفع المقدَّمة صالحة (على سبيل المثال، انتهت صلاحية بطاقة الائتمان).
  • تجاوزت حدود الحصة لواجهة برمجة تطبيقات معيّنة.

لاستخدام منتجات Google Maps Platform، يجب أن يكون لديك حساب فوترة، ويجب أن تتضمّن كل الطلبات مفتاح واجهة برمجة تطبيقات صالحًا. لحلّ هذه المشكلة، اتّبِع الخطوات التالية:

كيف يمكنني حلّ رموز الخطأ: kGMSPlacesRateLimitExceeded أو 9005 PLACES_API_RATE_LIMIT_EXCEEDED؟
إذا ظهر لك الرمز kGMSPlacesRateLimitExceeded أو 9005 PLACES_API_RATE_LIMIT_EXCEEDED، قد يعني ذلك أنّك تستخدم إصدارًا قديمًا من حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل Android أو حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS. يمكنك الاطّلاع على مزيد من المعلومات والعثور على حِزم SDK الجديدة على الرابط https://goo.gle/places-sdk-deprecation.
كيف يمكنني حلّ الخطأ "هذا عنوان IP أو الموقع الإلكتروني أو تطبيق الجوّال ليس لديه الإذن لاستخدام مفتاح واجهة برمجة التطبيقات هذا"؟

هناك سيناريوهات مختلفة قد تؤدي إلى حدوث هذا الخطأ:

  • فعّلت قيود عنوان IP (الخادم) على مفتاح واجهة برمجة التطبيقات، ويحاول عنوان IP غير المصرّح به إرسال طلب.
  • فعّلت قيود مُحيل HTTP (الموقع الإلكتروني) على مفتاح واجهة برمجة التطبيقات، ويحاول مُحيل غير مصرّح به إرسال طلب.
  • لقد حصرت الاستخدام على تطبيقات Android من خلال ضبط اسم الحزمة ومعرفها، ويحاول تطبيق Android غير المصرَّح به إرسال طلب.
  • إذا كنت قد حظرت الطلبات الواردة من تطبيقات iOS من خلال تحديد معرّفات الحِزم وحاول تطبيق iOS غير معروف إرسال طلب
  • كان من الممكن ظهور هذا الخطأ في السابق إذا كنت تستخدم أيًا من واجهات برمجة تطبيقات خدمات الويب، مع مفتاح واجهة برمجة تطبيقات يتضمّن قيودًا على مُحيل HTTP. يجب تحديد طلبات البيانات من واجهات برمجة التطبيقات هذه باستخدام مفتاح واجهة برمجة تطبيقات مع قيود عنوان IP. بدِّل نوع القيود المفروضة على المفتاح من قيد على مُحيل HTTP إلى قيد على عنوان IP. لمزيد من المعلومات عن حظر مفاتيح واجهة برمجة التطبيقات، يُرجى الاطّلاع على أفضل الممارسات المتعلّقة بمفاتيح واجهة برمجة التطبيقات.

عرض بيانات اعتماد مفتاح واجهة برمجة التطبيقات وتعديلها

للاطّلاع على مفاتيح واجهة برمجة التطبيقات وإدارة أي قيود، اتّبِع الخطوات التالية:

  1. انتقِل إلى صفحة "بيانات الاعتماد" في وحدة تحكّم Cloud.
  2. اختَر المشروع الذي يحتوي على مفتاح واجهة برمجة التطبيقات الذي تريد مراجعته.
  3. للاطّلاع على تفاصيل بيانات الاعتماد، بما في ذلك أي قيود تم ضبطها للمفتاح، انقر على اسم المفتاح من قائمة مفاتيح واجهة برمجة التطبيقات.
  4. يتم عرض بيانات الاعتماد الكاملة لمفتاح واجهة برمجة التطبيقات المحدّد، بما في ذلك أي قيود تم إعدادها للمفتاح. من هنا، يمكن تغيير القيود أو حذفها أو تعديلها حسب الحاجة.
كيف يمكنني حلّ الخطأ "لا يمكن استخدام مفاتيح واجهة برمجة التطبيقات التي تتضمّن قيودًا على المُحيل مع واجهة برمجة التطبيقات هذه"؟

إذا كنت تستخدِم أيًا من واجهات برمجة تطبيقات خدمات الويب باستخدام مفتاح واجهة برمجة تطبيقات مخصّص لمُحيل HTTP لأسباب تتعلق بالأمان، يجب أن تستخدم واجهات برمجة تطبيقات خدمة الويب مفاتيح واجهة برمجة التطبيقات المخصّصة لعناوين IP. بدِّل نوع القيود المفروضة على المفتاح من قيد مُحيل HTTP إلى قيد عنوان IP، أو أنشئ مفتاح واجهة برمجة تطبيقات جديدًا إذا سبق استخدام مفتاحك مع واجهة برمجة التطبيقات JavaScript API في "خرائط Google".

خدمات "منصة خرائط Google"

أحتاج إلى تحويل العناوين إلى أزواج من خطوط العرض/خطوط الطول. هل يمكنني إجراء ذلك باستخدام "منصة خرائط Google"؟

نعم، تُعرف هذه العملية باسم "ترميز جغرافي". تتضمّن واجهة برمجة التطبيقات Maps JavaScript API فئة لتنفيذ خدمة ترميز المواقع الجغرافية. الفئة هي: google.maps.Geocoder.

بدلاً من ذلك، توفّر Google أيضًا واجهة برمجة التطبيقات Geocoding API، التي توفّر واجهة REST يمكنها الردّ بتنسيقَي JSON وXML.

ما هي البلدان التي تتوفّر فيها ميزة ترميز المواقع الجغرافية؟

للاطّلاع على البلدان التي تتوفّر فيها حاليًا خدمات "منصة خرائط Google" لتحديد المواقع الجغرافية، يُرجى الرجوع إلى بيانات تغطية "خرائط Google".

قد تختلف دقة المواقع الجغرافية المشفَّرة جغرافيًا حسب البلد، لذا عليك استخدام الحقل المعروض location_type لتحديد ما إذا تم العثور على مطابقة جيدة بما يكفي لأغراض تطبيقك. يُرجى العِلم أنّ مدى توفّر data بيانات الترميز الجغرافي يعتمد على عقودنا مع موفّري البيانات، لذا فهو عرضة للتغيير.

لماذا تقدّم أدوات تحديد المواقع الجغرافية في "منصة خرائط Google" مواقع جغرافية مختلفة عن "خرائط Google"؟

يستخدم أحيانًا المعرّف الجغرافي لواجهة برمجة التطبيقات والمعرّف الجغرافي في "خرائط Google" مجموعات بيانات مختلفة (حسب البلد). يتمّ تعديل ترميز الموقع الجغرافي لواجهة برمجة التطبيقات من حين لآخر باستخدام بيانات جديدة، لذا يمكنك توقّع رؤية تغييرات في النتائج أو تحسينها بمرور الوقت.

كيف يمكنني تنسيق طلبات رمز الموقع الجغرافي لزيادة عدد الطلبات الناجحة إلى أقصى حدّ؟

تم تصميم أداة ترميز المواقع الجغرافية لربط عناوين الشوارع بالإحداثيات الجغرافية. لذلك، ننصحك بتنسيق طلبات ترميز الموقع الجغرافي وفقًا للإرشادات التالية لزيادة احتمالية إجراء طلب بحث ناجح إلى أقصى حد:

  • حدِّد العناوين وفقًا للتنسيق المستخدَم في الخدمة البريدية الوطنية للبلد المعني.
  • لا تحدِّد عناصر عنوان إضافية، مثل أسماء الأنشطة التجارية أو أرقام الوحدات أو أرقام الطوابق أو أرقام الشقق التي لا يتم تضمينها في العنوان على النحو المحدّد من قِبل الخدمة البريدية في البلد المعني. وقد يؤدي ذلك إلى ظهور الردود التي تتضمّن ZERO_RESULTS.
  • يجب تنسيق رموز Plus كما هو موضّح هنا (يتم ترميز علامات الجمع إلى %2B ويتم ترميز المسافات إلى %20):
    • الرمز العالمي هو رمز منطقة مكوّن من 4 أحرف ورمز محلي مكوّن من 6 أحرف أو أكثر (849VCWC8+R9 هو 849VCWC8%2BR9).
    • الرمز المركب هو رمز محلي مكوّن من 6 أحرف أو أكثر يشير إلى موقع جغرافي محدّد (CWC8+R9 Mountain View, CA, USA هو CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • استخدِم رقم الشارع للمبنى بدلاً من اسم المبنى متى أمكن.
  • استخدِم أرقام الشوارع بدلاً من تحديد الشوارع المتقاطعة متى كان ذلك ممكنًا.
  • لا تقدِّم "تلميحات"، مثل المعالم المجاورة.
كيف يمكنني تنسيق عنوان في الولايات المتحدة على طريق سريع مرقّم لتحويله إلى عنوان جغرافي؟

يتطلّب مُشفِّر الخرائط في Google Maps Platform تحديد الطرق السريعة المرقّمة في الولايات المتحدة في العناوين على النحو التالي:

  • طرق المقاطعات: "Co Road NNN" حيث يكون NNN هو رقم الطريق، على سبيل المثال: "Co Road 82"
  • الطرق السريعة الحكومية: "State NNN" حيث يكون الولاية هو الاسم الكامل للولاية وNNN هو رقم الطريق السريع. على سبيل المثال: "California 82"
  • الطرق السريعة في الولايات المتحدة: "U.S. NNN" حيث يكون NNN هو رقم الطريق السريع. مثال: "U.S. 101"
  • الطرق السريعة بين الولايات الأمريكية: "Interstate NNN" حيث يكون NNN هو رقم الطريق السريع بين الولايات. على سبيل المثال: "Interstate 280"
متى يجب استخدام فئة "محوِّل ترميز جغرافي" لواجهة برمجة التطبيقات ومتى يجب استخدام "خدمة ترميز جغرافي" عبر HTTP؟

اطّلِع على المستند: استراتيجيات معالجة الترميز الجغرافي، الذي يوضّح بالتفصيل الإيجابيات والسلبيات لاستراتيجيات معالجة الترميز الجغرافي المختلفة.

كيف يمكنني تقديم اتجاهات القيادة باستخدام "منصّة خرائط Google"؟

تتيح لك خدمة احتساب المسارات في Routes API وDirections API تقديم اتجاهات القيادة لرحلات فردية ورحلات متعددة المراحل. تساعدك خيارات التوجيه في تحديد الاتجاهات باستخدام وضع التنقّل (القيادة) ومسار واحد أو مجموعة من المسارات والقيود (عدم استخدام الطرق التي تفرض رسومًا). تتوفّر هذه الخدمات بالأشكال التالية:

  • واجهة طلب/استجابة HTTP (المستخدَمة في التطبيقات المتوافقة مع الأجهزة الجوّالة والتطبيقات الأخرى) متوافقة مع حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android وخدمات الويب الأخرى في "خرائط Google".
  • تتيح لك JavaScript API، للتطبيقات من جهة العميل، تقديم الاتجاهات إلى وجهة معيّنة من خلال فئة google.maps.DirectionsService. يمكن لفئة DirectionsRenderer إنشاء لوحة التراكبات والاتجاهات تلقائيًا نيابةً عنك. يتم تقديم أمثلة إضافية في المستندات.
  • توفر واجهات Java وPython وgo وNode.js للعملاء وظائف مماثلة للتطبيقات من جهة الخادم. لمزيد من المعلومات عن مكتبات العملاء، يُرجى الاطّلاع على مكتبات عملاء Directions API.
ما هي البلدان التي تتوفّر فيها اتجاهات القيادة؟

للاطّلاع على البلدان التي تتوفّر فيها حاليًا ميزة "اتجاهات القيادة" في منتجات "منصّة خرائط Google"، يمكنك الرجوع إلى بيانات تغطية "خرائط Google". يُرجى العِلم أنّ توفّر بيانات اتجاهات القيادة يعتمد على عقودنا مع موفّري البيانات، وهو يخضع للتغيير.

ما هي البلدان التي تتوفّر فيها اتجاهات النقل العام؟

تتيح كل من Directions API و Distance Matrix API لجميع شركاء Google Transit، باستثناء الشركاء في اليابان.

ما هي ميزات KML وGeoRSS المتوافقة مع واجهة برمجة التطبيقات JavaScript API في "خرائط Google"؟

تتيح فئة KmlLayer في Maps JavaScript API للمطوّرين تراكب ملفات KML/KMZ وملفَّات GeoRSS على الخريطة. يمكنك الاطّلاع على المستندات والأمثلة هنا.

ما هي الحدود المفروضة على حجم ملفات KML وتعقيدها والتي يمكن عرضها باستخدام فئة KmlLayer من Maps JavaScript API؟

يمكنك الاطّلاع على حدود الحجم والتعقيد لعرض ملفات KML باستخدام فئة KmlLayer هنا.

كيف يمكنني عرض ملفات KML المستضافة على مواقع интраنيت على خريطة؟

فئة KmlLayer التي تُنشئ تراكبات KML في Maps JavaScript API تستخدِم خدمة مستضافة على Google لاسترداد ملفات KML و تحليلها لعرضها. وبالتالي، لا يمكن عرض ملفّات KML التي لا تكون مستضافة على عنوان URL متاح بشكل علني أو التي تتطلّب مصادقة للوصول إليها.

إذا كنت بحاجة إلى تطوير تطبيقات تستخدِم ملفات KML مستضافة على مواقع داخلية، ننصحك بعرض ملفات KML من جهة العميل باستخدام مكتبات JavaScript التابعة لجهات خارجية. بما أنّه يتم تحليل ملف KML من قِبل المتصفّح، قد يكون الأداء أقلّ من استخدام فئة KmlLayer.

ما هو الحد الأقصى لعدد العلامات أو رؤوس المسارات التي تتوافق مع واجهة برمجة التطبيقات Maps Static API؟

ما مِن حدّ أقصى لعدد العلامات أو رؤوس المسارات المتوافقة مع واجهة برمجة التطبيقات Maps Static API. عند استخدام رموز مخصّصة، يمكن تحديد ما يصل إلى خمسة رموز فريدة لكل طلب، ولكن يمكن استخدام كل رمز عدة مرات في الخريطة.

يُرجى العلم أنّ عناوين URL لواجهة برمجة التطبيقات "الخرائط الثابتة" يمكن أن تحتوي على 8,192 حرفًا كحد أقصى، ما يحدّ من عدد العلامات ونقاط ملفّ المسار التي يمكن تحديدها استنادًا إلى عدد الأرقام العشرية المُستخدَمة عند تحديد كل زوج من خطوط الطول/العرض. للحصول على معلومات عن كيفية ارتباط عدد المواضع العشرية المستخدَمة بالدقة على سطح الأرض، يمكنك الاطّلاع على مقالة درجات Decimal في Wikipedia.

لماذا لا يمكنني الوصول إلى منتجات Google Maps Platform في بلدان معيّنة؟

لا يجوز استخدام واجهات برمجة التطبيقات في "خرائط Google" في المناطق المحظورة. يُرجى أيضًا الاطّلاع على بنود الخدمة.

كيف يمكنني الإبلاغ عن مشكلة في الخريطة الأساسية من Google؟
يمكنك إرسال ملاحظات من خلال "خرائط Google" بشأن معلومات الخريطة الخاطئة أو غير المتوفّرة، مثل:
  • عناوين أو أماكن محدّدات مواقع خاطئة
  • أسماء طرق غير صحيحة
  • معلومات خاطئة عن الطرق الأحادية الاتجاه والطرق المزدوجة الاتجاه
  • طريق مرسوم بشكل غير صحيح
  • طرق مغلقة
  • طرق غير موجودة

لتصحيح بطاقة بيانات مكان أو نشاط تجاري، يمكنك اقتراح تعديل.

إذا كان يجب إزالة محتوى "خرائط Google" لأسباب قانونية، يُرجى إرسال طلب قانوني.

بالنسبة إلى الطلبات الملحّة أو الحسّاسة للوقت، يُرجى إرسال طلب دعم يتضمّن تفاصيل محدّدة حول ما يجب إصلاحه.

كيف يتم رصد أداء الخدمات المستخدَمة مع واجهة برمجة التطبيقات Maps JavaScript API؟

تمّ تجهيز بعض الميزات من جهة العميل للإبلاغ عن حالات النجاح أو التوقّف بغرض احتساب هدف مستوى الخدمة (SLO). يتم إرسال هذه المعلومات إلى Google في maps.googleapis.com/maps_api_js_slo/log في المكالمات التي تسجِّل معلومات SLO. وتشمل هذه المعلومات حالة النجاح ووقت الاستجابة والإصدار/القناة لواجهة برمجة التطبيقات Maps JavaScript API المستخدَمة. قد يتم تجميع المكالمات لتحسين الأداء. يُرجى العِلم أنّه قد تحتاج إلى السماحmaps.googleapis.com في سياسة أمان المحتوى لضمانعدم حظر هذه الطلبات على مستوى المتصفّح. على سبيل المثال: Content-Security-Policy: default-src 'self' maps.googleapis.com; مع عناوين HTTP، أو <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> مع العلامات الوصفية HTML.

Maps JavaScript API

ما هي مدة عمل واجهة برمجة تطبيقات JavaScript لخرائط Google بعد تحميلها؟

يجب إعادة تحميل الصفحة التي تحمّل واجهة برمجة التطبيقات JavaScript خرائط Google مرة واحدة على الأقل كل 5 أيام.

حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS

كيف يمكنني حلّ الخطأ: kGMSPlacesRateLimitExceeded؟
إذا ظهر لك هذا الخطأ، من المحتمل أنّك تستخدم إصدارًا قديمًا من حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" على نظام التشغيل iOS. تم إيقاف الإصدار 2.7.0 من حزمة تطوير برامج "الأماكن" لنظام التشغيل iOS ولم يعُد متاحًا. يُرجى تحديث تطبيقك لاستخدام أحدث إصدار في أقرب وقت ممكن. راجِع دليل نقل البيانات للاطّلاع على التفاصيل.
تحدث لي أعطال عند تصحيح الأخطاء باستخدام جهاز iOS 8.x. ماذا يجب أن أفعل؟

إذا واجهت مشاكل عند تصحيح الأخطاء باستخدام الأجهزة التي تعمل بنظام التشغيل iOS 8.x، اتّبِع هذه الخطوات لإيقاف ميزة "التقاط اللقطات باستخدام وحدة معالجة الرسومات" في مخطّط XCode الذي تستخدمه:

  1. في XCode، اختَر المنتج (Product)، ثم المخطّط (Scheme)، ثم إدارة المخطّطات (Manage Schemes).
  2. اختَر مخطّطًا وانقر على تعديل....
  3. اضبط خيار التقاط اللقطات باستخدام وحدة معالجة الرسومات على غير مفعَّل. يُرجى العِلم أنّه قد لا يكون هذا الخيار متوفّرًا على جميع الأجهزة.
خيار Xcode GPU Frame Capture في صفحة Generic iOS device (جهاز iOS عام)
ما هو تأثير الشاشات المستديرة والأوسع على حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" على نظام التشغيل iOS؟

بدءًا من هاتف iPhone X، تتميز هواتف iPhone بشاشة ذات زوايا مُستديرة وفتحة في أعلى الشاشة لبيت الاستشعار بالجهاز ومُؤشر في أسفل الشاشة للوصول إلى الشاشة الرئيسية. اعتبارًا من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS 11.0، أضافت Apple واجهة برمجة التطبيقات Safe Area API التي تتيح للمطوّرين وضع العناصر في منطقة آمنة من القطع بسبب شكل الشاشة الجديد.

تتضمّن حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من "خرائط Google" العديد من العناصر المرئية وعناصر التحكّم، مثل أداة اختيار المساحات الداخلية ورابط الإبلاغ عن مشكلة. في الإصدار 2.4، يمكن أن يتم اقتصاص هذه العناصر المرئية وعناصر التحكّم من خلال شكل الشاشة الجديد. في الوضع المُعدّ للعرض على الشاشة العريضة، قد يتم اقتصاص أداة اختيار الأرضية الداخلية إما من خلال الشاشة المُثقوبة أو مؤشر زر الشاشة الرئيسية.

من خلال الإصدار 2.5 من حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" على نظام التشغيل iOS، يتم حلّ هذه المشاكل المتعلّقة بالتنسيق تلقائيًا. عند استخدام تطبيقك على هاتف iPhone X أو إصدار أحدث، يتم زيادة الحشو في GMSMapView وGMSPanoramaView كي لا يتم اقتصاص العناصر المرئية.

سنضمّن تلقائيًا دائمًا الحشو. تفترض حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS أنّ الغرض من الحشو هو الحشو من داخل المنطقة الآمنة. إذا صمّمت واجهتك بافتراض أنّ كل العناصر موزّعة ضمن المنطقة الآمنة، ستعمل هذه الطريقة بدون أي جهد إضافي.

إذا كنت قد صمّمت واجهة لا تعمل مع الإعداد التلقائي للتعديل، أضفنا سمة جديدة إلى GMSMapView تُسمى paddingAdjustmentBehavior. تتيح لك أداة GMSMapView الآن الاختيار من بين أحد سلوكَي تعديل الحشوَين التاليَين: "دائمًا" (الإعداد التلقائي) و"تلقائي" و"أبدًا".

إذا تم ضبط GMSMapView لاستخدام سلوك الحشو "دائمًا"، سيتم دائمًا إضافة الأجزاء المضمّنة للمساحة الآمنة إلى الحشو. يتيح لك ذلك تصميم واجهتك بافتراض أنّ جميع مواضع الإعلانات تبدأ من حواف المنطقة المؤهّلة للعرض. هذه هي القيمة الافتراضية.

إذا تم ضبط GMSMapView لاستخدام سلوك الحشو "التلقائي"، سيختار دائمًا الحشو الأكبر أو الجزء المُدمَج من المنطقة الآمنة. سيتيح لك ذلك إضافة هوامش من حافة الشاشة مع ضمان بقاء كل العناصر داخل المنطقة الآمنة في جميع الأوقات.

إذا تم ضبط GMSMapView لاستخدام سلوك الحشو "Never" (عدم تكرار الإجراء مطلقًا)، لن تتم إضافة العناصر المضمّنة للمساحة الآمنة إلى الحشو مطلقًا. كان هذا السلوك ساريًا قبل الإصدار 2.5 ، وقد يكون مفيدًا إذا كان الحشو يأخذ في الاعتبار المنطقة الآمنة، أو إذا كانت السلوكيات الأخرى لا تعمل بشكل جيد مع واجهتك. تقع على عاتقك مسؤولية التأكّد من أنّ شعار Google وإشعارات حقوق الطبع والنشر مرئيان دائمًا، كما هو موضّح في بنود خدمة "منصة خرائط Google".

في المقابل، لا تحتوي GMSPanoramaView على خاصية مساحة فارغة اختيارية. وهذا يعني أنّه ما مِن مساحة فارغة لتعديلها، وسيتم تطبيق GMSPanoramaView دائمًا على أي مساحة فارغة ضرورية لضمان أن تكون كل العناصر المرئية ضمن المنطقة الآمنة.

حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android

كيف يمكنني حلّ الخطأ: 9005 PLACES_API_RATE_LIMIT_EXCEEDED؟
إذا ظهرت لك رسالة الخطأ هذه، من المحتمل أنّك تستخدم إصدارًا قديمًا من حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" على Android. تم إيقاف إصدار "خدمات Google Play" من حزمة تطوير برامج "الأماكن" لأجهزة Android، ولم يعُد متاحًا. يُرجى تحديث تطبيقك لاستخدام أحدث إصدار في أقرب وقت ممكن. راجِع دليل نقل البيانات للاطّلاع على التفاصيل.
لا يعرض تطبيقي سوى مربّعات فارغة باللون الرمادي بدلاً من خريطة. كيف يمكنني حلّ هذه المشكلة؟

إنّ المشاكل في المصادقة هي السبب الشائع لظهور مربّعات رمادية فارغة بدلاً من الخريطة. يمكنك اتّباع الخطوات أدناه لتحديد هذه المشاكل وحلّها باستخدام adb logcat.

  1. تأكَّد من تثبيت adb. وإذا لم يكن الأمر كذلك، يمكنك اتّباع الدليل هنا.
  2. ثبِّت التطبيق الذي يعرض المشكلة على جهاز أو محاكي Android. إذا كنت تستخدم محاكي Android، تأكَّد من أنّ إعدادات المحاكي تتضمّن "متجر Play".
  3. في محطة Android Studio الطرفية، شغِّل adb logcat -e "Google Maps Android API". لن يتم طباعة سوى السطور التي تتطابق فيها رسالة السجلّ مع "Google Maps Android API". (يمكنك اختياريًا إخراج السجلّ إلى ملف نصي من خلال إلحاق: > logcat.txt)
  4. أعِد إنتاج المشكلة على جهازك وتحقَّق من الأخطاء الشائعة، مثل:
    • تتم الإشارة إلى مفتاح واجهة برمجة التطبيقات غير الصحيح أو غير المقصود في البيان.
    • لم يتم تفعيل الفوترة في "المشروع".
    • لم يتم تفعيل حزمة تطوير البرامج (SDK) في واجهات برمجة تطبيقات المشروع.
    • تتم إضافة بصمة SHA1 غير الصحيحة إلى قيود مفتاح واجهة برمجة التطبيقات.
    • لم يتم تضمين البرامج الاعتمادية لخدمة Google Play في ملف build.gradle.

توقيع عنوان URL

هل يمكنني توقيع عناوين URL باستخدام JavaScript؟

ننصحك بشدة بعدم توقيع عناوين URL باستخدام JavaScript لأنّ ذلك يؤدي إلى إظهار سرّ توقيع عنوان URL للمستخدمين النهائيين. لذلك، يجب أن يتم إنشاء التوقيعات فقط بواسطة المكوّنات من جهة الخادم.

لماذا أتلقّى استجابة HTTP 403 محظور لطلبات خدمة الويب في خرائط Google؟

تشير استجابة HTTP 403 إلى مشكلة في الإذن، ويعود السبب على الأرجح إلى عدم التمكّن من التحقّق من صحة التوقيع لهذا الطلب. قد يكون السبب أيًا مما يلي:

  1. تم تحديد توقيع غير صحيح لهذا الطلب.
  2. يحدّد الطلب مفتاح واجهة برمجة التطبيقات لخطة Google Maps Platform Premium، ولكنه لا يحدّد توقيعًا، وتتطلّب الخدمة التي يتمّ استدعاؤها أن تتضمّن الطلبات التي يتمّ إجراؤها باستخدام مفتاح واجهة برمجة التطبيقات توقيعًا صالحًا.
  3. تم تحديد توقيع ولكن لم يتم تحديد مفتاح واجهة برمجة التطبيقات المرتبط بخطة Google Maps Platform Premium.