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

البدء

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

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

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

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

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

Maps JavaScript API

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

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

توقيع عنوان URL

البدء

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

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

خرائط Google:

المسارات:

الأماكن:

البيئة:

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

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

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

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

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

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

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

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

راجع أيضًا:

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

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

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

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

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

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

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

متصفحات الويب التي تستخدم واجهة برمجة تطبيقات JavaScript للخرائط إتاحة استخدام Maps Embed API؟

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

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

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

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

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

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

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

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

في حال فقدت إمكانية الوصول إلى حسابك على Google (مثل [email protected] أو [email protected])، يمكنك محاولة استعادة إمكانية الدخول إلى الحساب من خلال استرداد كلمة المرور أو إعادة تعيينها. انتقل إلى كيفية استرداد حسابك على Google أو Gmail في مساعدة حساب Google.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

هل الأسعار متاحة بعملات أخرى؟

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

القيود:

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

واجهة برمجة التطبيقات/حزمة تطوير البرامج (SDK) بيانات الاعتماد قيود التطبيق
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android مفتاح واجهة برمجة التطبيقات مع فرض قيود على نظام التشغيل Android1
حزمة تطوير برامج الأماكن لأجهزة Android مفتاح واجهة برمجة التطبيقات مع فرض قيود على نظام التشغيل Android1
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS مفتاح واجهة برمجة تطبيقات مع قيود على نظام التشغيل iOS1
حزمة تطوير برامج الأماكن لأجهزة iOS مفتاح واجهة برمجة تطبيقات مع قيود على نظام التشغيل iOS1
واجهة برمجة تطبيقات JavaScript للخرائط مفتاح واجهة برمجة التطبيقات مع فرض قيود على مُحيل HTTP1
واجهة Map Tiles API مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1
واجهة برمجة تطبيقات مجموعات بيانات "خرائط Google" رمز OAuth المميز
واجهة برمجة تطبيقات Aerial View مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1
واجهة برمجة التطبيقات الثابتة في "خرائط Google" مفتاح واجهة برمجة التطبيقات مع فرض قيود على مُحيل HTTP1 + التوقيع الرقمي2
واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" مفتاح واجهة برمجة التطبيقات مع فرض قيود على مُحيل HTTP1 + التوقيع الرقمي2
واجهة برمجة التطبيقات لتضمين الخرائط مفتاح واجهة برمجة التطبيقات مع فرض قيود على مُحيل HTTP1
واجهة برمجة تطبيقات التحقق من صحة العناوين مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1
واجهة برمجة التطبيقات للاتجاهات مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1
واجهة برمجة التطبيقات لمصفوفة المسافة مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1
واجهة برمجة التطبيقات Eliffation مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1
Geocoding API مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1
واجهة برمجة التطبيقات لرصد الموقع الجغرافي مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1
واجهة Places API مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1
واجهة برمجة التطبيقات للطرق مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1
واجهة Routes API مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1
واجهة برمجة تطبيقات المنطقة الزمنية مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1
واجهة برمجة تطبيقات جودة الهواء مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1
واجهة برمجة تطبيقات Pollen مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1
Solar API مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1
1 القيود المفروضة على مفتاح واجهة برمجة التطبيقات اختيارية، ولكننا ننصح بشدة بتقييد جميع مفاتيح واجهة برمجة التطبيقات لمزيد من الأمان.
2 بناءً على الاستخدام، قد يكون التوقيع الرقمي مطلوبًا واجهة برمجة التطبيقات الثابتة للخرائط أو واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" وبغض النظر عن الاستخدام، ننصحك بشدة باستخدام كلاً من مفتاح واجهة برمجة التطبيقات والتوقيع الرقمي لمصادقة طلباتك.
كيف يمكنني تغيير نوع تقييد المفتاح من مُحيل HTTP إلى تقييد عنوان IP؟

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Maps JavaScript API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

توقيع عنوان URL

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

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

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

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

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