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

البدء

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

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

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

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

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

Maps JavaScript API

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

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

توقيع عنوان URL

البدء

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

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

الخرائط:

المسارات:

الأماكن:

البيئة:

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

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

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

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

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

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

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

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

راجع أيضًا:

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

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

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

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

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

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

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

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

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

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

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

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

عليك الاشتراك في مدونة Google Maps Platform للاطّلاع على آخر الأخبار بشأن العروض المتنوعة لمطوّري برامج 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 على أجهزة Mac الجديدة المستندة إلى Arm، إلا أنّ الأمر يتطلّب إنشاء جهاز iOS وتشغيله على جهاز iOS فعلي. ويشكّل ذلك قيدًا مؤقتًا بينما ندرس إمكانية توفير المزيد من الدعم للتطوير على المحاكيات.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

لا يجوز لك تخزين وعرض نُسخ من الصور التي تم إنشاؤها باستخدام Maps Static API من موقعك الإلكتروني. ويجب أن تربط جميع صفحات الويب التي تتطلب صورًا ثابتة السمة 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 نقطة في المليون
طرقات 30,000 QPM
المسارات: حوسبة المسارات 3,000 QPM
المسارات: حوسبة المسارات 3,000 EPM
الطاقة الشمسية 600 نقطة في اليوم
الخرائط الثابتة 30,000 QPM
واجهة برمجة تطبيقات صور التجوّل الافتراضي 30,000 QPM
المنطقة الزمنية 30,000 QPM

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

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

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

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

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

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

يتم شحن حمل خريطة واحد في إحدى الحالات التالية:

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

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

  • يتم تحصيل رسوم بانوراما ثابتة لميزة "التجوّل الافتراضي" لكل طلب يتم إرساله إلى واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" لتضمين صورة بانوراما ثابتة (غير تفاعلية) للتجوّل الافتراضي.
  • يتم تحصيل رسوم بانوراما ديناميكية في ميزة "التجوّل الافتراضي" مقابل كل مثيل من عنصر بانوراما في واجهة برمجة تطبيقات 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 للخرائط وهي: الاتجاهات ومصفوفة المسافة والارتفاع والترميز الجغرافي.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

القيود:

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

API/SDK بيانات الاعتماد والقيود المفروضة على التطبيقات
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android مفتاح واجهة برمجة تطبيقات مع قيود مفروضة على Android1
حزمة تطوير برامج الأماكن لأجهزة Android مفتاح واجهة برمجة تطبيقات مع قيود مفروضة على Android1
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS مفتاح واجهة برمجة تطبيقات مع قيود مفروضة على iOS1
حزمة تطوير برامج الأماكن لأجهزة iOS مفتاح واجهة برمجة تطبيقات مع قيود مفروضة على iOS1
واجهة برمجة تطبيقات JavaScript للخرائط مفتاح واجهة برمجة التطبيقات مع تقييد مُحيل HTTP1
واجهة برمجة تطبيقات مربّعات الخرائط مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة تطبيقات Aerial View مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة التطبيقات الثابتة للخرائط مفتاح واجهة برمجة التطبيقات مع قيود محيل HTTP1 + التوقيع الرقمي2
واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" مفتاح واجهة برمجة التطبيقات مع قيود محيل HTTP1 + التوقيع الرقمي2
واجهة برمجة التطبيقات لتضمين الخرائط مفتاح واجهة برمجة التطبيقات مع تقييد مُحيل HTTP1
واجهة برمجة تطبيقات التحقق من صحة العنوان مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Directions API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة التطبيقات لمصفوفة المسافات مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة التطبيقات للارتفاعات مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة تطبيقات الترميز الجغرافي مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة التطبيقات Geolocation API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة تطبيقات الأماكن مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Roads API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Routes API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة تطبيقات المنطقة الزمنية مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة التطبيقات Air Quality مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة التطبيقات لحبوب اللقاح مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة التطبيقات Solar API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
1 إنّ القيود المفروضة على مفاتيح واجهة برمجة التطبيقات اختيارية، ولكنّنا ننصح بشدة بحظر جميع مفاتيح واجهة برمجة التطبيقات لزيادة مستوى الأمان.
2 وفقًا للاستخدام، قد يكون التوقيع الرقمي مطلوبًا لكل من واجهة برمجة التطبيقات الثابتة لتطبيق "خرائط Google" وواجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي". بغض النظر عن الاستخدام، ننصحك بشدة باستخدام كل من مفتاح واجهة برمجة التطبيقات والتوقيع الرقمي لمصادقة طلباتك.
كيف يمكنني تبديل نوع تقييد المفتاح من مُحيل HTTP إلى قيد عنوان IP؟

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

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

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

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

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

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

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

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

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

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

كيف يمكنني عرض منتجات "منصة خرائط 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 الأوكرانية
hi الهندية ur الأوردية
hu المجرية uz الأوزبكية
هو الأيسلندية vi الفيتنامية
id الإندونيسية zu الزولو
it الإيطالية

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

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

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

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

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

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

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

بعد التأكد من رصد الأخطاء الجديدة أو أنّ الوظائف الحالية لمنتجات "منصة خرائط Google" لا تستوفي متطلباتك، يُرجى الإبلاغ عن الخطأ أو طلب الميزة باستخدام أداة تتبُّع المشاكل في "منصة خرائط 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) لخدمة "الأماكن" لنظام التشغيل 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.
  • يجب تنسيق رموز المواقع المفتوحة كما هو موضّح هنا (يتم استخدام أحرف الإلغاء في عنوان 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" حيث يشير State إلى الاسم الكامل للولاية و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 للتطبيقات من جهة العميل تتيح لك تقديم اتجاهات القيادة عبر فئة google.maps.DirectionsService. ويمكن أن تنشئ فئة DirectionsRenderer بشكلٍ تلقائي الإعلانات المركّبة ولوحة الاتجاهات لك. تتوفر أمثلة إضافية في المستندات.
  • واجهات عميل Java وPython وgo وNode.js توفّر الوظائف نفسها في التطبيقات من جهة الخادم. لمزيد من المعلومات عن مكتبات العملاء، يمكنك الاطّلاع على مكتبات عميل Directions API.
ما هي البلدان التي تتوفر فيها اتجاهات القيادة؟

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

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

يمكن استخدام Directions API وواجهة برمجة التطبيقات Matrix للمسافات مع جميع شركاء Google Transit، باستثناء الشركاء في اليابان.

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

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

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

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

كيف يمكنني عرض ملفات KML المستضافة على مواقع شبكة داخلية على الخريطة؟

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مع إصدار SDK 2.5 لنظام التشغيل 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) لخدمة "أماكن Google" لنظام التشغيل Android. تم إيقاف إصدار "خدمات Google Play" من حزمة تطوير برامج الأماكن لأجهزة 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 محظورة على طلبات خدمة الويب API لخرائط؟

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

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