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

البدء

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

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

استخدام نظام خرائط Google الأساسي

الأخطاء وتحرّي الخلل وإصلاحه

خدمات نظام خرائط Google الأساسي

Maps JavaScript API

SDK لخرائط Google لنظام التشغيل iOS

SDK لخرائط Google لأجهزة Android

توقيع عنوان URL

البدء

ما المقصود بـ Google Maps Platform؟

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

الخرائط:

المسارات:

الأماكن:

كيف أبدأ مع Google Maps Platform؟

راجع بدء استخدام Google Maps Platform.

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

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

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

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

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

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

انظر أيضًا:

هل يمكنني وضع خرائط Google على موقعي دون استخدام منتجات نظام خرائط Google الأساسي؟

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

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

لدمج الخرائط في تطبيق متوافق مع Android، استخدِم SDK للخرائط على الأجهزة التي تعمل بنظام التشغيل Android.

لدمج الخرائط في تطبيق متوافق مع نظام التشغيل iOS، استخدِم SDK للخرائط على نظام التشغيل iOS.

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

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

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

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

أجهزة كمبيوتر سطح المكتب
  • الإصدار الحالي من 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
  • Safari للجوّال على الإصدارات الرئيسية الحالية والسابقة من iOS.
  • UIWebView وWKWebView على الإصدارات الرئيسية الحالية والسابقة من iOS.
  • الإصدار الحالي من Chrome لنظام التشغيل iOS.
هل يمكنني طباعة الخرائط من واجهة برمجة تطبيقات JavaScript للخرائط؟

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

كيف يمكنني إشعاري عند حدوث تغييرات في منتجات "منصة خرائط 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 التي تعمل بالذراع؟

ومع ذلك، فإن عملية التطوير على أجهزة Mac الجديدة التي تستند إلى جهاز Apple هي أمر محتمل، إلا أن ذلك يتطلب إنشاء وتشغيل على جهاز يعمل بنظام التشغيل 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 Maps Platform في مستند؟

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

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

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

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

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

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

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

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

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

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

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

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

واجهة برمجة التطبيقات حد الاستخدام
التحقق من العنوان 6,000 QPM
الاتجاهات 50 لقطة في الثانية
مصفوفة المسافة 1000 السهم (EP)
خرائط ديناميكية 500 لقطة في الثانية
الارتفاع 100 لقطة في الثانية
ترميز جغرافي 50 لقطة في الثانية
رصد الموقع الجغرافي 100 لقطة في الثانية
الأماكن 100 لقطة في الثانية
الطرق 500 لقطة في الثانية
المسارات: Compute Routes 3,000 QPM
المسارات: مصفوفة طريق الحوسبة 3,000 EPM
الخرائط الثابتة 500 لقطة في الثانية
واجهة برمجة تطبيقات صور التجوّل الافتراضي 500 لقطة في الثانية
المنطقة الزمنية 500 لقطة في الثانية

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

للاطّلاع على تقرير حركة المرور ومعلومات الفوترة لمشروع بالكامل، يُرجى اتّباع الخطوات التالية:

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

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

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

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

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

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

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

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

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

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

يحصل موقعي على عدد كبير من الزيارات. هل يمكنني استخدام منتجات Google Maps Platform؟

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

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

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

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

كم يكلفني استخدام نظام خرائط Google الأساسي؟

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

استخدام نظام خرائط Google الأساسي

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

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

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

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

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

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

القيود:

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

واجهة برمجة التطبيقات/حزمة تطوير البرامج (SDK) تقييد بيانات الاعتماد والتطبيق
حزمة تطوير البرامج (SDK) للخرائط في نظام التشغيل Android مفتاح واجهة برمجة التطبيقات مع قيود Android1
حزمة تطوير برامج الأماكن لأجهزة Android مفتاح واجهة برمجة التطبيقات مع قيود Android1
حِزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لأجهزة iOS مفتاح واجهة برمجة التطبيقات مع قيود iOS1
حزمة تطوير برامج الأماكن لأجهزة iOS مفتاح واجهة برمجة التطبيقات مع قيود iOS1
واجهة برمجة تطبيقات JavaScript للخرائط مفتاح واجهة برمجة التطبيقات مع تقييد مُحيل HTTP1
واجهة برمجة تطبيقات الخرائط الثابتة مفتاح واجهة برمجة التطبيقات مع تقييد مُحيل HTTP1 + التوقيع الرقمي2
واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" مفتاح واجهة برمجة التطبيقات مع تقييد مُحيل HTTP1 + التوقيع الرقمي2
واجهة برمجة التطبيقات لتضمين الخرائط مفتاح واجهة برمجة التطبيقات مع تقييد مُحيل HTTP1
واجهة برمجة تطبيقات التحقق من العنوان مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة تطبيقات الاتجاهات مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة التطبيقات لمصفوفة المسافات مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة تطبيقات Elevation مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة تطبيقات الترميز الجغرافي مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة تطبيقات الموقع الجغرافي مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة تطبيقات الأماكن مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة تطبيقات الطرق مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
Routes API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
واجهة برمجة تطبيقات المنطقة الزمنية مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1
1 قيود مفتاح واجهة برمجة التطبيقات اختيارية، ولكننا ننصح بشدة بتقييد جميع مفاتيح واجهة برمجة التطبيقات لزيادة الأمان.
2 وحسب الاستخدام، قد يُطلب منك توقيعًا رقميًا لكلٍّ من واجهة برمجة التطبيقات الثابتة للخرائط وواجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي". بغض النظر عن الاستخدام، ننصحك بشدة باستخدام كل من مفتاح واجهة برمجة التطبيقات والتوقيع الرقمي لمصادقة طلباتك.
كيف يمكنني تبديل نوع تقييد المفتاح من مُحيل 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 JavaScript.

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

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

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

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

رمز اللغة اللغة رمز اللغة اللغة
af الأفريقانية ja اليابانية
sq الألبانية kn الكانادا
صباحًا الأمهرية kk الكازاخستانية
ar العربية كم الخميرية
hy الأرمنية ko الكورية
az الأذربيجانية ky القيرغيزية
eu الباسكية lo اللاوية
بلجيكا البيلاروسية 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 لـ "خرائط Google" وواجهة برمجة تطبيقات الخرائط الثابتة وواجهات برمجة تطبيقات خدمة الويب عبر اتصالات (HTTPS) الآمنة. يُرجى الاطّلاع على مستندات واجهة برمجة التطبيقات المعنية للحصول على معلومات حول كيفية الوصول إلى واجهة برمجة التطبيقات هذه عبر طبقة المقابس الآمنة.

لاحظ أن واجهة برمجة تطبيقات الخرائط الثابتة لا تدعم عناوين URL للرموز المخصصة التي تستخدم HTTPS، وسيتم عرض الرمز الافتراضي.

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

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

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

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

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

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

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

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

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

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

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

الأخطاء وتحرّي الخلل وإصلاحه

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

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

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

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


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

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

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

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

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

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

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

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

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

خدمات نظام خرائط Google الأساسي

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

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

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

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

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

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

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

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

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

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

  • حدِّد العناوين وفقًا للتنسيق المستخدَم في خدمة البريد الوطنية في البلد المعني.
  • ولا تحدِّد عناصر عناوين إضافية، مثل أسماء الأنشطة التجارية أو أرقام الوحدات أو أرقام الطوابق أو أرقام الأجنحة التي لا يتم إدراجها في العنوان على النحو المحدّد في خدمة البريد في البلد المعني. قد يؤدي هذا الإجراء إلى الحصول على ردود باستخدام ZERO_RESULTS.
  • نسِّق رموز المواقع المفتوحة كما هو موضّح هنا (يتم وضع علامة زائد على عنوان URL بدلاً من علامات %2B عند إدخال عناوين URL، ويتم إلغاء أحرف عنوان 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 Maps Platform؟

تسمح لك خدمة "مسارات الحوسبة" من واجهة برمجة التطبيقات للمسارات وواجهة برمجة التطبيقات للاتجاهات بتوفير اتجاهات القيادة للرحلات الفردية ومتعددة الأرجل. تساعدك خيارات التوجيه على تشكيل الاتجاهات من خلال وضع السفر (القيادة)، وطريق واحدة أو مجموعة من المسارات، والقيود (بدون طرق ذات رسوم). تتوفر هذه الخدمات في النماذج التالية:

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

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

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

تتيح واجهة برمجة التطبيقات للاتجاهات وواجهة برمجة تطبيقات مصفوفة المسافة جميع شركاء Google Transit، باستثناء هؤلاء المقيمين في اليابان.

ما ميزات KML وGeoRSS المدعومة في واجهة برمجة تطبيقات جافا سكريبت للخرائط؟

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

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

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

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

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

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

ما هو الحد الأقصى لعدد العلامات أو رؤوس المسارات التي تتيحها واجهة برمجة تطبيقات الخرائط الثابتة؟

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

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

لماذا لا أستطيع الدخول إلى منتجات نظام خرائط Google لبلدان معينة؟

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

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

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

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

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

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

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

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

SDK لخرائط Google لنظام التشغيل iOS

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

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

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

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

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

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

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

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

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

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

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

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

SDK لخرائط Google لأجهزة Android

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

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

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

توقيع عنوان URL

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

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

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

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

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