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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

البدء

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

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

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

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

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

Maps JavaScript API

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

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

توقيع عناوين URL

البدء

ما هو النظام الأساسي لخدمة "خرائط Google"؟

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

الخرائط:

المسارات:

الأماكن:

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

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

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

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

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

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

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

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

راجع أيضًا:

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

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

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

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

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

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

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

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

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

جهاز الكمبيوتر المكتبي
  • الإصدار الحالي من Microsoft Edge (في نظام التشغيل Windows)
  • الإصدارات الحالية والسابقة من Firefox (لأنظمة التشغيل Windows وmacOS وLinux)
  • الإصدارات الحالية والسابقة من Chrome (أنظمة التشغيل Windows وmacOS وLinux)
  • الإصدارات الحالية والسابقة من Safari (نظام التشغيل macOS)

لإخلاء الموارد لتقديم الميزات التي يطلبها العملاء المتاحة للمتصفّحات الحديثة، تتوقف "منصة خرائط Google" عن إتاحة الإصدار 11 من Internet Explorer. أوقفت Microsoft الدعم للإصدار IE11 في العام 2021 وشجّعت على نقل البيانات إلى Microsoft Edge.

اعتبارًا من آب (أغسطس) 2021، بدأت رسالة تحذير في الظهور لمستخدمي Internet Explorer 11 في أعلى الخرائط. أحدث إصدار من Maps JavaScript API متوافق مع Internet Explorer 11 هو الإصدار 3.47. سيتم إيقاف دعم Internet Explorer 11 بالكامل في تشرين الثاني (نوفمبر) 2022. ينطبق هذا أيضًا على وضع IE في Edge.

نظام التشغيل Android
  • الإصدار الحالي من Chrome على الإصدار 4.1 من نظام التشغيل Android أو الإصدارات الأحدث.
  • Chrome WebView على الإصدار Android 4.4 والإصدارات الأحدث
iOS
  • متصفّح Safari على الأجهزة الجوّالة الرئيسية والإصدارات الحالية والسابقة من نظام التشغيل iOS
  • UIWebView وWKWebView على الإصدارات الرئيسية الحالية والسابقة من iOS.
  • الإصدار الحالي من Chrome لنظام التشغيل iOS.
هل يمكنني طباعة الخرائط من واجهة برمجة تطبيقات JavaScript ل"خرائط Google"؟

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

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

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

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

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

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

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

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

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

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

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

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

ومع ذلك، يمكن تطوير نظام التشغيل على أجهزة Mac الجديدة التي تعمل بالذراع، إلا أن ذلك يتطلب إنشاء نظام التشغيل 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" في التطبيقات غير المستندة إلى الويب، شرط أن يتم التقيّد بالقيود الأخرى الواردة في بنود خدمة "منصة خرائط Google".

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

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

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

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

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

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

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

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

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

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

واجهة برمجة التطبيقات حد الاستخدام
اتجاهات 50 كيلوبت في الثانية
مصفوفة المسافة 1000 سهم
الارتفاع 100 كيلوبت في الثانية
ترميز المواقع الجغرافية 50 كيلوبت في الثانية
رصد الموقع الجغرافي 100 كيلوبت في الثانية
الخرائط الديناميكية 500 كيلوبت في الثانية
الخرائط الثابتة 500 كيلوبت في الثانية
واجهة برمجة تطبيقات صور التجوّل الافتراضي 500 كيلوبت في الثانية
المنطقة الزمنية 500 كيلوبت في الثانية
الأماكن (باستثناء الأجهزة الجوّالة) 100 كيلوبت في الثانية
الطرق 500 كيلوبت في الثانية

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

إذا تجاوزت حدود الاستخدام، ستتلقّى رمز حالة 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. انقر على رمز التعديل بجانب الحصة "request&day for day".

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

القيود:

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

واجهة برمجة التطبيقات/حزمة تطوير البرامج (SDK) &بيانات الاعتماد، وقيود التطبيق
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android مفتاح واجهة برمجة تطبيقات مع قيود Android1
حزمة تطوير برامج الأماكن لأجهزة Android مفتاح واجهة برمجة تطبيقات مع قيود Android1
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS مفتاح واجهة برمجة تطبيقات مع قيود iOS1
حزمة تطوير برامج الأماكن لأجهزة iOS مفتاح واجهة برمجة تطبيقات مع قيود iOS1
Maps JavaScript API مفتاح واجهة برمجة التطبيقات مع تقييد مُحيل HTTP1
Maps Static API مفتاح واجهة برمجة التطبيقات مع تقييد مُحيل HTTP1 + التوقيع الرقمي2
واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" مفتاح واجهة برمجة التطبيقات مع تقييد مُحيل HTTP1 + التوقيع الرقمي2
Maps Include API مفتاح واجهة برمجة التطبيقات مع تقييد مُحيل HTTP1
Directions API مفتاح واجهة برمجة تطبيقات مع تقييد عنوان IP1
واجهة برمجة التطبيقات لمصفوفة المسافة مفتاح واجهة برمجة تطبيقات مع تقييد عنوان IP1
Elevation API مفتاح واجهة برمجة تطبيقات مع تقييد عنوان IP1
واجهة برمجة تطبيقات الترميز الجغرافي مفتاح واجهة برمجة تطبيقات مع تقييد عنوان IP1
واجهة برمجة تطبيقات رصد الموقع الجغرافي مفتاح واجهة برمجة تطبيقات مع تقييد عنوان IP1
Roads API مفتاح واجهة برمجة تطبيقات مع تقييد عنوان IP1
واجهة برمجة تطبيقات المنطقة الزمنية مفتاح واجهة برمجة تطبيقات مع تقييد عنوان IP1
الأماكن API مفتاح واجهة برمجة تطبيقات مع تقييد عنوان IP1
إنّ 1 قيود مفتاح واجهة برمجة التطبيقات اختيارية، ولكننا ننصح بشدة بتقييد جميع مفاتيح واجهة برمجة التطبيقات لزيادة مستوى الأمان.
2 بناءً على الاستخدام، قد يكون استخدام التوقيع الرقمي مطلوبًا لكل من Maps Static API وStreet Static API. وبغض النظر عن الاستخدام، ننصحك بضرورة استخدام مفتاح واجهة برمجة تطبيقات وتوقيع رقمي لمصادقة طلباتك.
كيف يمكنني تبديل نوع تقييد المفتاح من مُحيل HTTP إلى تقييد عنوان IP؟

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

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

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

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

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

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

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

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

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

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

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

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

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

يمكن الوصول إلى Maps API API وMaps Static API وWeb Service APIs عبر اتصالات (HTTPS) آمنة. يُرجى الاطّلاع على مستندات واجهة برمجة التطبيقات المعنية للحصول على معلومات حول كيفية الوصول إلى واجهة برمجة التطبيقات عبر طبقة المقابس الآمنة.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يتطلب أداة ترميز "منصة خرائط 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"؟

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

في Xcode 12، لا تعمل التطبيقات بشكل صحيح للمحاكي. كيف يمكنني حلّ هذه المشكلة؟

لحل هذه المشكلة، افتح "إعدادات إنشاء مشروع Xcode"، وأضِف arm64 إلى إصدارات Excluded Architectures للمحاكاة على iOS أو "iOS;، فقط.

لمزيد من المعلومات، يُرجى الاطّلاع على سلسلة محادثات StackOverflow التالية.

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

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

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

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

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

مع إصدار "خرائط Google" لحزمة iOS 2.5، يتم إصلاح مشاكل التنسيق هذه تلقائيًا. عند استخدام تطبيقك على هاتف iPhone X أو إصدار أحدث، تتم زيادة المساحة المتروكة على GMSmapView وGMSبانوراماView بحيث لا يتم اقتصاص العناصر المرئية.

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

إذا صمّمت واجهة لا تعمل مع التعديل التلقائي الذي أطلقناه، طرحنا موقعًا جديدًا على vCardMapView. تتيح لك GMSMapView الآن الاختيار من بين واحد من ثلاثة سلوكيات لتعديلات المساحة المتروكة: 'دائم&#39؛ (تلقائي)،'Automatic'، و#39;Never&#39؛

إذا تم ضبط GMSmapView لاستخدام سلوك 'دائمًا&#39؛ المساحة المتروكة، ستعمل دائمًا على إضافة مداخل المنطقة الآمنة إلى المساحة المتروكة. يتيح لك ذلك تصميم واجهة المستخدم بافتراض أنّ كل مواضع الإعلانات تكون من أطراف المنطقة الآمنة. هذه هي القيمة الافتراضية.

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

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

في المقابل، لا يتوفّر للسمة بانوراما في عرض Viewبانوراما عرض اختياري. ويعني ذلك أنّه ما من مساحة متروكة لتعديلها، وستُطبِّق خدمة {9/}بانوراما عرض دائمًا أي مساحة متروكة ضرورية لضمان أن تكون كل العناصر المرئية ضمن المنطقة الآمنة.

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

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

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

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

توقيع عناوين URL

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

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

لماذا أتلقّى ردًا محظورًا على HTTP 403 بشأن طلبات خدمة الويب باستخدام Maps API؟

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

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