الأسئلة الشائعة حول "منصة خرائط 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". يمكنك الاطّلاع على مزيد من المعلومات هنا.

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

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

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

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

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

ما هي متصفّحات الويب المتوافقة مع Maps JavaScript API وMaps Embed API؟

تتوافق واجهتا برمجة التطبيقات Maps JavaScript API وMaps Embed API مع متصفّحات الويب التالية:

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

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

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

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

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

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

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

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

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

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

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

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

هل يمكنني استخدام حزمتَي تطوير البرامج بالاستناد إلى بيانات "خرائط Google" و"الأماكن" للتطبيقات المتوافقة مع iOS على أجهزة Mac المستندة إلى معالجات Arm؟

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

لا تتوافق Maps JavaScript API إلا عند تشغيلها في أحد المتصفّحات المتوافقة.

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

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

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

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

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

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

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

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

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

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

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

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

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

هل هناك حدّ أقصى للاستخدام (الحصص) في "منصة خرائط Google"؟

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

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

واجهة برمجة التطبيقات الحدّ الأقصى للاستخدام
Address Validation ‫6,000 طلب في الدقيقة
‫Aerial View: البحث عن فيديو ‫180 طلب في الدقيقة و100,000 طلب في اليوم
‫Aerial View: عرض الفيديو ‫100 طلب في الدقيقة و100 طلب في اليوم
جودة الهواء ‫6,000 طلب في الدقيقة
‫Maps JavaScript API: الخرائط الثلاثية الأبعاد ‫30,000 طلب في الدقيقة
‫Maps JavaScript API: الخرائط الديناميكية ‫30,000 طلب في الدقيقة
الارتفاع ‫6,000 طلب في الدقيقة
ترميز جغرافي ‫3,000 طلب في الدقيقة
الموقع الجغرافي ‫6,000 طلب في الدقيقة
‫Maps Grounding Lite: البحث عن الأماكن، والبحث عن حالة الطقس، وحساب المسارات ‫300 طلب في الدقيقة لكل أداة
‫Maps Grounding Lite: حلّ الأسماء، وحلّ عناوين URL في "خرائط Google" ‫600 طلب في الدقيقة لكل طريقة
‫Map Tiles API: مربّعات الخرائط الثنائية الأبعاد 6,000 طلب في الدقيقة و15,000 طلب في اليوم
‫Map Tiles API: مربّعات في "التجوّل الافتراضي" 6,000 طلب في الدقيقة و15,000 طلب في اليوم
‫Map Tiles API: مربّعات ثلاثية الأبعاد لصور واقعية ‫12,000 طلب في الدقيقة و10,000 طلب جذر في اليوم
التنقّل: طلبات تحديد الوجهة ‫30,000 طلب في الدقيقة
أماكن ‫6,000 طلب في الدقيقة
تجميع بيانات الأماكن ‫1,200 طلب في الدقيقة
لقَاح ‫6,000 طلب في الدقيقة
الطرق ‫30,000 طلب في الدقيقة
Routes: Compute Routes ‫3,000 طلب في الدقيقة
Routes: Compute Route Matrix ‫3,000 حدث في الدقيقة
حالة الشمس ‫600 طلب في الدقيقة
الخرائط الثابتة ‫30,000 طلب في الدقيقة
واجهة برمجة تطبيقات صور التجوّل الافتراضي ‫30,000 طلب في الدقيقة
المنطقة الزمنية ‫30,000 طلب في الدقيقة
الطقس ‫6,000 طلب في الدقيقة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ملاحظة: تتوفّر خدمة مكافئة من جهة العميل في Maps JavaScript API لواجهات برمجة التطبيقات التالية لخدمات الويب: Elevation وGeocoding.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

القيود:

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

واجهة برمجة التطبيقات/حزمة تطوير البرامج (SDK) قيود بيانات الاعتماد والتطبيقات
حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android مفتاح واجهة برمجة التطبيقات مع قيود Android1
حزمة تطوير برامج الأماكن لأجهزة Android مفتاح واجهة برمجة التطبيقات مع قيود Android1
حزمة تطوير البرامج للتنقّل على أجهزة Android مفتاح واجهة برمجة التطبيقات مع قيود Android1
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS مفتاح واجهة برمجة التطبيقات مع قيود iOS‏1
حزمة تطوير برامج الأماكن لأجهزة iOS مفتاح واجهة برمجة التطبيقات مع قيود iOS‏1
حزمة تطوير البرامج للتنقّل على أجهزة iOS مفتاح واجهة برمجة التطبيقات مع قيود iOS‏1
Maps JavaScript API مفتاح واجهة برمجة التطبيقات مع حظر مُحيل HTTP‏1
Map Tiles API مفتاح واجهة برمجة التطبيقات مع حظر عنوان IP‏1
Maps Datasets API رمز OAuth مميّز
Aerial View API مفتاح واجهة برمجة التطبيقات مع حظر عنوان IP‏1
Maps Static API مفتاح واجهة برمجة التطبيقات مع حظر مُحيل HTTP1 + توقيع رقمي2
Street View Static API مفتاح واجهة برمجة التطبيقات مع حظر مُحيل HTTP1 + التوقيع الرقمي2
Maps Embed API مفتاح واجهة برمجة التطبيقات مع حظر مُحيل HTTP‏1
Address Validation API مفتاح واجهة برمجة التطبيقات مع حظر عنوان IP‏1
Elevation API مفتاح واجهة برمجة التطبيقات مع حظر عنوان IP‏1
Geocoding API مفتاح واجهة برمجة التطبيقات مع حظر عنوان IP‏1
Geolocation API مفتاح واجهة برمجة التطبيقات مع حظر عنوان IP‏1
Places API مفتاح واجهة برمجة التطبيقات مع حظر عنوان IP‏1
Places Aggregate API مفتاح واجهة برمجة التطبيقات مع حظر عنوان IP‏1
Roads API مفتاح واجهة برمجة التطبيقات مع حظر عنوان IP‏1
Routes API مفتاح واجهة برمجة التطبيقات مع حظر عنوان IP‏1
Time Zone API مفتاح واجهة برمجة التطبيقات مع حظر عنوان IP‏1
Air Quality API مفتاح واجهة برمجة التطبيقات مع حظر عنوان IP‏1
Pollen API مفتاح واجهة برمجة التطبيقات مع حظر عنوان IP‏1
Solar API مفتاح واجهة برمجة التطبيقات مع حظر عنوان IP‏1
Weather API مفتاح واجهة برمجة التطبيقات مع حظر عنوان IP‏1
‫1 القيود المفروضة على مفاتيح واجهة برمجة التطبيقات اختيارية، ولكننا ننصحك بشدة بفرض قيود على جميع مفاتيح واجهة برمجة التطبيقات لتعزيز الأمان.
‫2 استنادًا إلى الاستخدام، قد يكون التوقيع الرقمي مطلوبًا لكل من Maps Static API وStreet View Static API. بغض النظر عن الاستخدام، ننصحك بشدة باستخدام كل من مفتاح واجهة برمجة التطبيقات والتوقيع الرقمي لمصادقة طلباتك.
كيف يمكنني تبديل نوع القيود المفروضة على المفتاح من مُحيل HTTP إلى قيد على عنوان IP؟

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

لم يعُد بروتوكول SSL المتوقّف نهائيًا متاحًا.

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

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

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

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

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

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

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

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

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

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

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

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

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

ما هو معنى هذا الخطأ؟

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

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

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


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

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

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

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

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

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

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

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

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

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

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

نعم، تُعرف هذه العملية باسم "الترميز الجغرافي". تتضمّن Maps JavaScript API فئة لتنفيذ خدمة ترميز جغرافي. الفئة هي: google.maps.Geocoder.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

واجهة طلب/استجابة HTTP (المستخدَمة في الأجهزة الجوّالة والتطبيقات الأخرى) متوافقة مع حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android ومع خدمات الويب الأخرى في "خرائط Google".

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

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

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

تتيح واجهة برمجة التطبيقات Routes API استخدام جميع شركاء النقل العام من Google، باستثناء شركة Indian Railway Catering and Tourism Corporation والشركاء في اليابان.

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

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

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

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

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

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

لتصحيح بيانات مكان أو مؤسسة، يمكنك اقتراح تعديل.

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

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

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

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

ما هي مدة عمل Maps JavaScript API بعد تحميلها؟

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

لماذا أتلقّى ردًّا يتضمّن رمز الخطأ HTTP 403 Forbidden على طلبات خدمة الويب في Maps API؟

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

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