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

البدء

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

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

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

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

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

Maps JavaScript API

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

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

توقيع عنوان URL

البدء

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

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

الخرائط:

المسارات:

الأماكن:

البيئة:

كيف أبدأ مع "منصة خرائط Google"؟

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

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

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

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

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

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

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

راجع أيضًا:

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

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

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

لدمج الخرائط في تطبيق Android، استخدِم حزمة تطوير البرامج (SDK) الخاصة بخرائط Google لنظام التشغيل Android.

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

تم تطوير واجهة برمجة تطبيقات JavaScript للخرائط لتلبية احتياجات الأجهزة الجوّالة، وهي مناسبة لتطبيقات المتصفحات التي تستهدف كلاً من أجهزة الكمبيوتر المكتبي والأجهزة التي تتضمّن متصفّح ويب ينفّذ لغة JavaScript كاملةً، مثل Apple iPhone.

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

ما هي متصفّحات الويب التي تتيح استخدام "واجهة برمجة التطبيقات JavaScript JavaScript" و"واجهة برمجة التطبيقات لتضمين الخرائط في الخرائط"؟

تتوافق واجهة برمجة التطبيقات JavaScript JavaScript وواجهة برمجة التطبيقات لتضمين الخرائط في الخرائط مع متصفحات الويب التالية:

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

لا تتوفر إمكانية الطباعة من Maps JavaScript API. ويرجع ذلك إلى عدم اتساق إتاحة الطباعة في المتصفحات الشائعة الاستخدام.

كيف يتم إعلامي عند إجراء تغييرات على منتجات "منصة خرائط Google"؟

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يمكنك استخدام "منصة خرائط Google" في تطبيقاتك طالما أنّ موقعك الإلكتروني يستوفي بنود خدمة "منصة خرائط Google".

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

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

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

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

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

ما مِن قيود مفروضة على عرض البيانات في الوقت الفعلي (التتبُّع) باستخدام منتجات "منصة خرائط Google" شرط أن يتوافق التطبيق مع بنود خدمة "منصة خرائط Google".

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

API الحدّ الأقصى للاستخدام
إثبات صحة العنوان 6,000 QPM
العرض الملتقط من الجو: فيديو بحثي 180 QPM و100,000 QPD
العرض الملتقط من الجو: عرض الفيديو 100 QPM و100 QPD
أداة "جودة الهواء" 6,000 QPM
الاتجاهات 3,000 QPM
مصفوفة المسافة 60,000 EPM
الخرائط الديناميكية 30,000 QPM
الارتفاع 6,000 QPM
ترميز جغرافي 3,000 QPM
الموقع الجغرافي 6,000 QPM
Map Tiles API: شاشات ثنائية الأبعاد ومربّعات "التجوّل الافتراضي" 6,000 QPM و15,000 QPD
واجهة برمجة تطبيقات مربّعات الخرائط: شاشات ثلاثية الأبعاد ذات صور واقعية 300 QPD
واجهة برمجة تطبيقات مربّعات الخرائط: شاشات ثلاثية الأبعاد ذات صور واقعية: العارض 12,000 QPM
الأماكن 6,000 QPM
لقَاح 6,000 QPM
طرقات 30,000 QPM
المسارات: احتساب المسارات 3,000 QPM
المسارات: مصفوفة مسار Compute 3,000 EPM
الطاقة الشمسية 600 QPM
الخرائط الثابتة 30,000 QPM
واجهة برمجة تطبيقات صور التجوّل الافتراضي 30,000 QPM
المنطقة الزمنية 30,000 QPM

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

يجب نشر منتجات "منصة خرائط Google" بما يتوافق مع بنود خدمة "منصة خرائط Google" العادية.

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

للحصول على نظرة عامة على أسعار منتجات "منصة خرائط Google"، يُرجى الاطّلاع على ورقة الأسعار.

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

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

يتم تحميل خريطة واحدة في حال حدوث أي مما يلي:

  • تعرض صفحة ويب أو تطبيق خريطة باستخدام Maps JavaScript API.
  • يطلب أحد التطبيقات صورة خريطة واحدة من Maps Static API.

يتم شحن صور بانوراما 360 درجة بشكل منفصل عن عمليات تحميل الخرائط:

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

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

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

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

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

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

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

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

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

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

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

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

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

تم تجاوز الحدود القصوى المسموح بها للاستخدام

إذا تجاوزت حدود الاستخدام، ستتلقى رمز حالة OVER_QUERY_LIMIT كاستجابة.

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

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

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

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

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

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

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

ما تكلفة استخدام Google Maps Platform؟

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

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

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

لقد قمت بإعداد الفوترة. كيف يمكنني عرض فاتورتي؟

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

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

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

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

وضع الحدّ الأقصى اليومي للفوترة:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • يتم إنشاء توقيع رقمي باستخدام المفتاح السرّي لتوقيع عنوان URL الذي توفّره Google لك. تُستخدم التوقيعات الرقمية مع Maps Static API وواجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي".

القيود:

يوضّح الجدول أدناه القيود الأساسية/بيانات الاعتماد والتطبيقات لكل واجهة برمجة تطبيقات/حزمة تطوير برامج (SDK) لمنصة خرائط Google.

API/SDK بيانات الاعتماد والقيود المفروضة على التطبيقات
حزمة تطوير البرامج لتطبيق "خرائط Google" لأجهزة Android مفتاح واجهة برمجة التطبيقات مع قيود مفروضة على Android1
حزمة تطوير برامج الأماكن لأجهزة Android مفتاح واجهة برمجة التطبيقات مع قيود مفروضة على Android1
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS مفتاح واجهة برمجة التطبيقات مع قيود مفروضة على نظام التشغيل iOS1
حزمة تطوير برامج الأماكن لأجهزة iOS مفتاح واجهة برمجة التطبيقات مع قيود مفروضة على نظام التشغيل iOS1
واجهة برمجة تطبيقات JavaScript للخرائط مفتاح واجهة برمجة التطبيقات مع قيود محيل HTTP1
واجهة برمجة تطبيقات Map Tiles مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP1
Aerial View API مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP1
واجهة برمجة التطبيقات الثابتة للخرائط مفتاح واجهة برمجة التطبيقات مع قيود محيل HTTP1 + التوقيع الرقمي2
واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" مفتاح واجهة برمجة التطبيقات مع قيود محيل HTTP1 + التوقيع الرقمي2
واجهة برمجة التطبيقات لتضمين الخرائط مفتاح واجهة برمجة التطبيقات مع قيود محيل HTTP1
واجهة برمجة التطبيقات للتحقّق من العنوان مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP1
Directions API مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP1
واجهة برمجة التطبيقات لمصفوفة المسافات مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP1
Elevation API مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP1
واجهة برمجة تطبيقات الترميز الجغرافي مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP1
واجهة برمجة التطبيقات للموقع الجغرافي مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP1
واجهة برمجة تطبيقات الأماكن مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP1
واجهة برمجة التطبيقات للطرق مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP1
Routes API مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP1
واجهة برمجة تطبيقات المنطقة الزمنية مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان 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".

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

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

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

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

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

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

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

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

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

اللغات المعتمَدة:

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

رمز اللغة Language رمز اللغة Language
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 الأوكرانية
أهلاً الهندية ur الأوردية
hu المجرية uz الأوزبكية
هو الآيسلندية vi الفيتنامية
id الإندونيسية zu الزولو
it الإيطالية

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

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

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

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

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

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

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

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

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

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

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

لَمْ أَعْثُرْ عَلَى إِجَابَة عَنْ سُؤَالِي. بمن يمكنني التواصل؟

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

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

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

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

ماذا يعني هذا الخطأ؟

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

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

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


كيف يمكنني حل رمزي الخطأ: OVER_DAILY_LIMIT أو OVER_QUERY_LIMIT؟
يمكن عرض رموز الخطأ هذه لأيٍّ من الأسباب التالية:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يتطلب ترميز المواقع الجغرافية في "منصة خرائط Google" تحديد الطرق السريعة المُرقمة في الولايات المتحدة في العناوين على النحو التالي:

  • الطرق الإقليمية: "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"؟

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

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

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

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

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

ما هي ميزات KML وGeoRSS المتوافقة في Maps JavaScript API؟

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

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

يمكنك الاطّلاع هنا على الحدود القصوى للحجم والتعقيد على عرض 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 حرفًا كحدّ أقصى، وهو ما يحدّ من عدد العلامات وعناوين المسارات التي يمكن تحديدها استنادًا إلى عدد المنازل العشرية المستخدمة عند تحديد كل زوج من خطوط الطول والعرض. للحصول على معلومات حول طريقة ارتباط عدد المنازل العشرية المستخدمة بالدقة على الأرض، يُرجى الاطّلاع على مقالة ويكيبيديا حول الدرجات العشرية.

لماذا لا يمكنني الوصول إلى منتجات "منصة خرائط Google" في بلدان معيّنة؟

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

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

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

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

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

كيف يتم مراقبة أداء الخدمات المستخدمة مع Maps JavaScript API؟

يتم استخدام بعض الميزات من جانب العميل للإبلاغ عن النجاح أو الإخفاق بغرض حساب هدف مستوى الخدمة (SLO). يتم إرسال هذه المعلومات إلى Google على الرقم maps.googleapis.com/maps_api_js_slo/log في المكالمات التي تسجّل معلومات هدف مستوى الخدمة. وتشمل هذه المعلومات حالة النجاح ووقت الاستجابة وإصدار/قناة واجهة برمجة تطبيقات JavaScript لتطبيق "خرائط Google" قيد الاستخدام. وقد يتم تجميع المكالمات بناءً على الأداء. ملاحظة: قد تحتاج إلى السماح باستخدام 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 للخرائط بعد تحميلها؟

تحتاج إلى تحديث الصفحة التي تحمِّل Maps JavaScript API مرة واحدة على الأقل كل 5 أيام.

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

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

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

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

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

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

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

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

إذا صمّمت واجهة لا تعمل مع التسوية التلقائية، قدمنا خاصية جديدة لـ GMSMapView، تسمى ملء عمل التسوية. يتيح لك GMSMapView الآن الاختيار من بين ثلاثة سلوكيات لتعديلات المساحة المتروكة: "دائمًا" (تلقائي) و"تلقائي" و"مطلقًا".

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

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

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

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

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

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

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

  1. تأكَّد من تثبيت أداة Adb. وإذا لم يكن الأمر كذلك، يمكنك اتّباع الدليل هنا.
  2. ثبِّت التطبيق الذي يعرض المشكلة على جهاز أو محاكي Android. في حال استخدام "محاكي Android"، تأكّد من تضمين "متجر Play" في إعدادات المحاكي.
  3. في الوحدة الطرفية "استوديو Android"، شغِّل 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 محظورة لطلبات خدمة الويب الخاصة بـ Maps API؟

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

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