البدء
- ما هي "منصة خرائط Google"؟
- كيف يمكنني البدء باستخدام "منصة خرائط Google"؟
- ما هي واجهة برمجة التطبيقات التي أحتاج إليها؟
- كيف أبدأ باستخدام واجهات برمجة التطبيقات على موقعي الإلكتروني؟
- ما هي البلدان التي توفّر فيها "منصة خرائط Google"؟
- هل يمكنني عرض "خرائط Google" على موقعي الإلكتروني بدون استخدام منتجات "منصّة خرائط Google"؟
- كيف يمكنني إرسال تطبيقات "خرائط Google" على الأجهزة الجوّالة؟
- ما هي متصفّحات الويب المتوافقة مع واجهتَي برمجة التطبيقات Maps JavaScript API و Maps Embed API؟
- هل يمكنني طباعة الخرائط من واجهة برمجة التطبيقات Maps JavaScript API؟
- كيف يمكنني تلقّي إشعارات عند إجراء تغييرات على منتجات "منصة خرائط Google"؟
- كيف يمكنني التواصل مع فريق الدعم الفني؟
- متى يتوفّر الدعم الفني؟
- كيف يمكنني استرداد إمكانية الوصول إلى حسابي على Google؟
- كيف يمكنني استعادة إمكانية الوصول إلى مشروع معيّن؟
- هل يمكنني استخدام حزمة تطوير البرامج (SDK) لتطبيقَي "خرائط Google" و"الأماكن" لنظام التشغيل iOS على أجهزة Mac المستندة إلى معالجات Arm؟
فهم بنود الخدمة
- ما هي بنود الخدمة لمنتجات "منصة خرائط Google"؟
- هل يستوفي موقعي الإلكتروني بنود خدمة "منصة خرائط Google"؟
- هل يمكنني الوصول مباشرةً إلى مربّعات الخرائط وصور الأقمار الصناعية؟
- هل يمكنني استخدام منتجات Google Maps Platform لتتبُّع التطبيقات؟
- هل يمكنني استخدام منتجات Google Maps Platform في تطبيقي غير المتوافق مع الويب؟
- هل يمكنني استخدام منتجات "منصة خرائط Google" على موقع إلكتروني محمي بكلمة مرور؟
- هل يمكنني إنشاء تطبيق يشتمل على بيانات "منصة خرائط Google" في مستند؟
- كيف يمكنني إيقاف تضمين المحتوى الخاص بي في نتائج "بحث Google"؟
- هل يمكنني إنشاء صورة خريطة باستخدام Maps Static API التي أحفظها وأعرضها من موقعي الإلكتروني؟
حدود الاستخدام والفوترة
- كيف يمكنني إعداد الفوترة لمشروعي؟
- كيف يمكن لعملاء "المستوى المجاني" من Google Cloud Platform الترقية إلى حساب مدفوع؟
- هل هناك حدود لاستخدام "منصة خرائط Google"؟
- كيف يتم احتساب تكلفة الاستخدام؟
- كيف يتم احتساب عمليات تحميل الخرائط على "منصة خرائط Google"؟
- كيف يمكنني مراقبة استخدام حصتي؟
- ماذا يحدث في حال تجاوزت حدود الاستخدام؟
- يتلقّى موقعي الإلكتروني عددًا كبيرًا من الزيارات. هل يمكنني استخدام منتجات "منصة خرائط Google"؟
- إذا أصبح موقعي الإلكتروني أو تطبيقي رائجًا فجأةً، هل ستتوقف خرائطي عن العمل؟
- كيف سيتم احتساب الاستخدام وتحصيل الفواتير؟
- ما هي تكلفة استخدام "منصة خرائط Google"؟
- هل الأسعار متاحة بعملات أخرى؟
- لقد أعددت الفوترة. كيف يمكنني الاطّلاع على فاتورتي؟
- كيف أتجنّب دفع فاتورة كبيرة في حال زيادة استخدامي بشكل غير متوقع؟
- لقد تلقّيتُ رسالة تفيد بأنّ مشروعي مرتبط بـ "حساب نقل بيانات من منصة Google Maps "، ولكن لا يمكنني الوصول إلى هذا الحساب. فماذا أفعل؟
- لماذا تم ضبط الحد الأقصى للحصة على طلب واحد في اليوم؟ كيف يمكنني رفع هذا الحدّ؟
- لقد تلقيتُ إشعارًا بانتهاك الفوترة. كيف يمكنني حلّ هذه المشكلة؟
استخدام "منصة خرائط Google"
- ما هي المفاتيح أو بيانات الاعتماد التي يجب استخدامها لمنتجات "منصة خرائط Google" المختلفة؟
- كيف يمكنني تبديل نوع القيود المفروضة على المفتاح من إشارة HTTP إلى قيد عنوان IP؟
- كيف يمكنني الحصول على مفتاح واجهة برمجة تطبيقات جديد؟
- كيف يمكنني العثور على التغييرات التي تم إدخالها في كل إصدار من إصدارات "منصة خرائط Google"؟
- كيف يمكنني تحميل واجهة برمجة التطبيقات إلى صفحة بشكل غير متزامن بعد تحميل الصفحة؟
- كيف يمكنني عرض منتجات "منصة خرائط Google" بلغة أخرى غير الإنجليزية؟
- هل يمكن الوصول إلى Google Maps Platform عبر طبقة المقابس الآمنة (HTTPS)؟
- كيف يمكنني الإبلاغ عن خطأ أو طلب ميزة جديدة في "منصة خرائط Google"؟
- كيف تستخدِم واجهات برمجة التطبيقات في Google Maps Platform ملفات تعريف الارتباط الخاصة بالمواقع الإلكترونية؟
- لا أستطيع العثور على إجابة عن سؤالي. ما هي الجهة التي يمكنني التواصل معها؟
الأخطاء وتحديد المشاكل وحلّها
- ماذا يعني هذا الخطأ؟
- تظهر خرائطي بشكل أغمق من المعتاد. ماذا يحدث؟
-
كيف يمكنني حلّ رموز الخطأ
OVER_DAILY_LIMIT
أوOVER_QUERY_LIMIT
؟ -
كيف يمكنني معالجة رمزَي الخطأ:
kGMSPlacesRateLimitExceeded
أو9005 PLACES_API_RATE_LIMIT_EXCEEDED
؟ - كيف يمكنني حلّ الخطأ "عنوان IP أو الموقع الإلكتروني أو تطبيق الجوّال هذا ليس لديه إذن باستخدام مفتاح واجهة برمجة التطبيقات هذا"؟
- كيف يمكنني حل الخطأ: "لا يمكن استخدام مفاتيح واجهة برمجة التطبيقات التي لها قيود على المُحيلين مع واجهة برمجة التطبيقات هذه".
خدمات "منصة خرائط Google"
- أحتاج إلى تحويل العناوين إلى أزواج خطوط العرض/الطول. هل يمكنني فعل ذلك باستخدام منصة خرائط Google؟
- ما هي البلدان التي تتوفّر فيها ميزة ترميز المواقع الجغرافية؟
- لماذا تقدّم خدمة "تحديد المواقع الجغرافية" في "منصّة خرائط Google" مواقع جغرافية مختلفة عن تلك التي تقدّمها "خرائط Google"؟
- كيف يمكنني تنسيق طلبات البحث في خدمة ترميز المواقع الجغرافية لزيادة عدد الطلبات الناجحة إلى أقصى حد؟
- كيف يمكنني تنسيق عنوان على طريق سريع مرقّم في الولايات المتحدة لتحويله إلى عنوان جغرافي؟
- متى يجب استخدام فئة "محوِّل الرموز الجغرافية" لواجهة برمجة التطبيقات ومتى يجب استخدام "خدمة تحديد المواقع الجغرافية" عبر HTTP؟
- كيف يمكنني تقديم اتجاهات القيادة باستخدام "منصّة خرائط Google"؟
- ما هي البلدان التي تتوفر فيها اتجاهات القيادة؟
- ما هي البلدان التي تتوفر فيها اتجاهات النقل العام؟
- ما هي ميزات KML وGeoRSS المتوافقة مع واجهة برمجة التطبيقات JavaScript API في "خرائط Google"؟
- ما هي الحدود المفروضة على حجم ملفات KML وتعقيدها والتي يمكن عرضها باستخدام فئة KmlLayer من واجهة برمجة التطبيقات Maps JavaScript API؟
- كيف يمكنني عرض ملفات KML المستضافة على مواقع الشبكات الداخلية على خريطة؟
- ما الحد الأقصى لعدد العلامات أو رؤوس المسار التي يدعمها واجهة برمجة التطبيقات الثابتة للخرائط؟
- لماذا لا يمكنني الوصول إلى منتجات "منصة خرائط Google" لبلدان معيَّنة؟
- كيف يمكنني الإبلاغ عن مشكلة في الخريطة الأساسية من Google؟
- كيف يتم تتبُّع الأداء للخدمات المستخدَمة مع واجهة برمجة التطبيقات Maps JavaScript API؟
Maps JavaScript API
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS
-
كيف يمكنني إصلاح الخطأ:
kGMSPlacesRateLimitExceeded
؟ - تظهر أعطال عند تصحيح الأخطاء باستخدام جهاز iOS 8.x. ماذا يجب أن أفعل؟
- ما هو تأثير الشاشات المستديرة والأوسع على حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" على نظام التشغيل iOS؟
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android
-
كيف يمكنني حلّ الخطأ:
9001 Operation failed due to exceeding the quota usage limit
؟ - لا يعرض تطبيقي سوى مربّعات رمادية فارغة بدلاً من خريطة. كيف يمكنني حلّ هذه المشكلة؟
توقيع عنوان URL
- هل يمكنني توقيع عناوين URL باستخدام JavaScript؟
- لماذا أتلقّى استجابة HTTP 403 محظور لطلبات خدمة الويب في Maps API؟
البدء
- ما هي "منصة خرائط Google"؟
-
"منصّة خرائط Google" هي مجموعة من واجهات برمجة التطبيقات وحِزم تطوير البرامج (SDK) التي تسمح للمطوّرين بتضمين "خرائط Google" في التطبيقات المتوافقة مع الأجهزة الجوّالة وصفحات الويب، أو لاسترداد البيانات من "خرائط Google". هناك العديد من العروض. استنادًا إلى احتياجاتك، قد تستخدم واحدة أو مجموعة من واجهات برمجة التطبيقات ومجموعات تطوير البرامج (SDK) التالية:
خرائط Google:
- واجهة برمجة تطبيقات JavaScript للخرائط
- حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android
- حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS
- واجهة برمجة تطبيقات "شاشات المعلومات"
- واجهة برمجة تطبيقات Aerial View
- Maps Static API
- واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي"
- عناوين URL في خرائط Google
- واجهة برمجة التطبيقات لتضمين الخرائط
- Maps Datasets API
المسارات:
- Routes API
- واجهة برمجة تطبيقات الطرق
- واجهة برمجة التطبيقات للاتجاهات
- Distance Matrix API
- Route Optimization API
- حزمة تطوير البرامج للتنقّل على Android
- حزمة تطوير البرامج للتنقّل لنظام التشغيل iOS
الأماكن:
- Places API
- حزمة تطوير برامج "الأماكن" لأجهزة Android
- حزمة تطوير برامج "الأماكن" لأجهزة iOS
- Places Library، واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google"
- واجهة برمجة تطبيقات التحقق من صحة العنوان
- Geocoding API
- واجهة برمجة التطبيقات لرصد الموقع الجغرافي
- واجهة برمجة تطبيقات المنطقة الزمنية
البيئة:
- كيف يمكنني البدء في استخدام "منصة خرائط 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، توفّر Maps Static API صور الخرائط بتنسيقات GIF وJPG وPNG، بما في ذلك العلامات والخطوط المتعددة. يُرجى العِلم أنّ استخدام واجهة برمجة التطبيقات Maps Static API خارج التطبيقات المبنية على المتصفّح يتطلّب ربط صورة الخريطة بخرائط Google.
- متصفحات الويب التي تستخدم واجهة برمجة تطبيقات JavaScript للخرائط إتاحة استخدام Maps Embed API؟
-
تتوافق واجهتا برمجة التطبيقات Maps JavaScript API وMaps Embed API مع متصفّحات الويب التالية:
أجهزة الكمبيوتر المكتبي- الإصدار الحالي من Microsoft Edge (لنظام التشغيل Windows)، باستثناء وضع IE
- أحدث إصدارين رئيسيين ثابتين من Firefox (أنظمة التشغيل Windows وmacOS وLinux).
- أحدث إصدارين رئيسيين ثابتين من Chrome (أنظمة التشغيل Windows وmacOS وLinux).
- أحدث إصدارَين رئيسيَّين ثابتَين من Safari (نظام التشغيل macOS)
- الإصدار الحالي من Chrome على نظام التشغيل Android 4.1 والإصدارات الأحدث.
- Chrome WebView على الإصدار 4.4 من نظام التشغيل Android والإصدارات الأحدث
- متصفّح Safari للأجهزة الجوّالة على الإصدارات الرئيسية الحالية والسابقة من نظام التشغيل iOS
- UIWebView وWKWebView على الإصدارات الرئيسية الحالية والسابقة من نظام التشغيل iOS
- الإصدار الحالي من Chrome لأجهزة iOS
- هل يمكنني طباعة الخرائط من Maps JavaScript API؟
-
لا تتوفر الطباعة من واجهة برمجة تطبيقات JavaScript للخرائط. هذا لأن الطباعة الدعم غير متسق عبر المتصفحات الشائعة الاستخدام.
- كيف يمكنني تلقّي إشعارات عند إجراء تغييرات على منتجات "منصة خرائط Google"؟
-
يجب عليك الاشتراك في منصة خرائط Google مدونة للحصول على آخر الأخبار عبر مختلف العروض المختلفة لمطوّري المواقع الجغرافية على Google
- كيف يمكنني التواصل مع فريق الدعم الفني؟
-
الاطّلاع على المراجع والدعم في "منصة خرائط Google" للحصول على معلومات حول خيارات الدعم المتاحة
- متى يتوفّر الدعم الفني؟
- فريق الدعم متاح على مدار الساعة طوال أيام الأسبوع (خلال أيام الأسبوع من الاثنين الساعة 9 صباحًا، بتوقيت طوكيو حتى الجمعة، 5 بعد الظهر توقيت المحيط الهادئ) باستثناء العطلات الإقليمية لطلب البحث "خدمة غير قابلة للاستخدام" المشكلات.
- كيف يمكنني استرداد إمكانية الوصول إلى حسابي على Google؟
-
في حال فقدت إمكانية الوصول إلى حسابك على Google (مثل joe@mycompany.com أو joe@gmail.com)، يمكنك محاولة استعادة إمكانية الدخول إلى الحساب من خلال استرداد كلمة المرور أو إعادة تعيينها. انتقل إلى كيفية استرداد حسابك على Google أو Gmail في مساعدة حساب Google.
- ملاحظة: لاستعادة إمكانية الوصول إلى حساب G Suite، اطلب من مشرف مؤسستك إلغاء حذف الحساب.
- كيف يمكنني استعادة إمكانية الوصول إلى مشروع معيّن؟
-
إذا فقدت إمكانية الوصول إلى المشروع الذي تدير فيه عملية تنفيذ "منصة خرائط Google"، يمكنك محاولة استرداده.
في حال كان بإمكانك الوصول إلى حساب Google المرتبط بمشروعك:
- إذا كنت تعرف مالك المشروع ولديك إذن الوصول إلى حسابك على Google: اطلب من مالك المشروع
إضافة
بصفتك مالك مشروع أو محرِّر في المشروع
- إذا كان مشروعك جزءًا من مؤسسة: تواصَل مع المؤسسة المشرفين وتطلب منهم إضافة بصفتك مالك مشروع.
- إذا لم تكن تعرف أيًا من مالكي المشروع الحاليين: إذا كنت لا تعرف مالك المشروع، أو إذا كان مالك المشروع غير متاح، يمكنك التواصل مع فريق الدعم لاستكشاف خيارات إضافية لاسترداد المشروع.
إذا لم يكن بإمكانك الوصول إلى حسابك على Google المرتبط بمشروعك:
- إذا فقدت إمكانية الوصول إلى حسابك على Google: حاول لاسترداد اسم المستخدم أو كلمة المرور لحسابك.
- إذا لم تتمكّن من استرداد إمكانية الوصول إلى حسابك على Google: أنشئ حسابًا جديدًا على Google، الاتصال بمالك مشروع حالي وتطلب منه إضافة حسابك الجديد على Google إلى المشروع
- إذا كنت تعرف مالك المشروع ولديك إذن الوصول إلى حسابك على Google: اطلب من مالك المشروع
إضافة
بصفتك مالك مشروع أو محرِّر في المشروع
- هل يمكنني استخدام حزمة تطوير البرامج (SDK) الخاصة بـ "خرائط Google" و"الأماكن" لنظام التشغيل iOS على أجهزة Mac المستندة إلى Gemini؟
-
يمكن إجراء عملية التطوير على أجهزة Mac الجديدة المستندة إلى Arm، ولكن يتطلّب ذلك إنشاء التطبيق وتشغيله على جهاز iOS. هذا قيد مؤقت بينما ننظر في إضافة المزيد من الدعم وتطويرها باستخدام أجهزة المحاكاة.
فهم بنود الخدمة
- ما هي بنود خدمة منتجات "منصة خرائط Google"؟
-
يمكنك الاطّلاع على بنود خدمة Google Maps Platform على الرابط التالي:
- هل يستوفي موقعي الإلكتروني بنود خدمة Google Maps Platform؟
-
يمكنك استخدام "منصة خرائط Google" في تطبيقاتك طالما توافق موقعك الإلكتروني مع بنود خدمة "منصة خرائط Google".
ومع ذلك، هناك بعض الاستخدامات لمنصّة "خرائط Google" التي لا نريد رؤيتها: على سبيل المثال، الخرائط التي تحدّد أماكن شراء الأدوية المحظورة في مدينة معيّنة أو أي نشاط غير قانوني آخر. نحن نحترم أيضًا خصوصية المستخدمين، لذلك يجب عدم استخدام "منصّة خرائط Google" لتحديد المعلومات الخاصة بالأفراد.
عليك الاستعانة بمستشارك الخاص لتحديد ما إذا كان تطبيقك يمتثل لبنود خدمة "منصّة خرائط Google" قبل تطويره وإطلاقه. يمكن لمهندسي Google تقديم المساعدة الفنية فقط مؤهلاً لتقديم المشورة القانونية تحتفظ Google بالحق في تعليق أو بإنهاء استخدامك للخدمة في أي وقت، لذا يُرجى قراءة بنود واجهات برمجة تطبيقات الخرائط بعناية.
- هل يمكنني الوصول مباشرةً إلى مربّعات الخرائط وصور الأقمار الصناعية؟
-
لا يجوز لك الوصول إلى مربّعات الخرائط أو صور القمر الصناعي من خلال أي آلية غير منصة خرائط Google (مثل إنشاء واجهة برمجة تطبيقات خاصة بك للخرائط أو استخدام النص البرمجي لتنزيل إطار متجانب). سيتم منع تطبيقك من الوصول إلى المربّعات إذا كان يصل إليها خارج "منصّة خرائط Google". يمكنك الاطّلاع على بنود خدمة "منصة خرائط Google" لمزيد من التفاصيل.
- هل يمكنني استخدام منتجات "منصة خرائط Google" لتتبُّع التطبيقات؟
-
لا يوجد أي قيود على عرض البيانات في الوقت الفعلي (التتبّع) باستخدام منتجات Google Maps Platform شرط أن يمتثل التطبيق لبنود خدمة Google Maps Platform.
- هل يمكنني استخدام "خرائط Google" في تطبيقي غير المستند إلى الويب؟
-
نعم، يمكن الآن استخدام منتجات "منصّة خرائط Google" في التطبيقات غير المخصّصة للويب، شرط أن تكون متوافقة مع القيود الأخرى الواردة في بنود خدمة "منصّة خرائط Google".
لا يتم دعم واجهة برمجة تطبيقات JavaScript للخرائط إلا عند تشغيلها في أحد المتصفحات المتوافقة
- هل يمكنني استخدام منتجات "منصة خرائط Google" على موقع إلكتروني محمي بكلمة مرور؟
-
نعم، يمكن استخدام "خرائط Google" و"المسارات" و"الأماكن" وخدمات "البيئة" مع التطبيقات التي تتيح الوصول الخاص . يُرجى الاطّلاع على بنود خدمة Google Maps Platform لمعرفة المزيد من التفاصيل.
- هل يمكنني إنشاء تطبيق يشتمل على بيانات "منصة خرائط Google" في مستند؟
-
إذا أنشأ طلبك مستندًا، سواء في شكل إلكتروني أو مطبوع، قد لا يتم تضمين أي بيانات من "منصة خرائط Google"، بما في ذلك الصور. يُرجى الاطّلاع على بنود خدمة "منصة خرائط Google" قسم "عدم استخدام برامج جمع البيانات" للحصول على مزيد من التفاصيل.
- كيف يمكنني إيقاف تضمين المحتوى الخاص بي في نتائج "بحث Google"؟
-
لم نعُد نجمع هذه البيانات. استخدام
indexing
تم إيقاف العمل بها وليس لها أي تأثير. لم تعُد بحاجة إلى إيقاف الميزة ولكننا نشجعك على إزالة هذه المعلمة في أقرب وقت ممكن والراحة.لإزالة صفحتك أو موقعك الإلكتروني من نتائج البحث، يُرجى اتّباع التعليمات الواردة في مركز مساعدة مشرفي المواقع.
- هل يمكنني إنشاء صورة خريطة باستخدام واجهة برمجة التطبيقات الثابتة لخدمة "خرائط Google" التي أحفظها وأعرضها من موقعي الإلكتروني؟
-
لا يجوز لك تخزين نُسخ من الصور التي تم إنشاؤها باستخدام واجهة برمجة التطبيقات Maps Static API من موقعك الإلكتروني وعرضها. جميع صفحات الويب التي تتطلب يجب أن تربط الصور الثابتة السمة
src
في ملف HTML العلامةimg
أو سمة CSSbackground-image
لإحدى السمات علامةdiv
HTML مباشرةً إلى واجهة برمجة التطبيقات الثابتة للخرائط بحيث يتم عرض جميع صور الخريطة ضمن محتوى HTML لصفحة الويب التي تعرضها Google مباشرةً للمستخدمين النهائيين.
حدود الاستخدام والفوترة
- كيف يمكنني إعداد الفوترة لمشروعي؟
- اطّلِع على بدء استخدام "منصة خرائط Google".
- كيف يمكن لعملاء "المستوى المجاني" من Google Cloud Platform الترقية إلى حساب مدفوع؟
- يقدّم برنامج الإصدار المجاني من Google Cloud Platform للعملاء فترة تجريبية بدون أي رسوم مع رصيد بقيمة 300 دولار أمريكي لاستخدامه مع أي خدمة من خدمات Google Cloud، بما في ذلك واجهات برمجة تطبيقات Google Maps Platform. عند انتهاء الفترة التجريبية المتاحة بدون رسوم، عليك الترقية إلى حساب مدفوع لمواصلة استخدام هذه الخدمات. للترقية إلى حساب مدفوع، يُرجى الانتقال إلى Cloud Console.
- هل هناك حدود لاستخدام منصة خرائط Google؟
-
ما مِن حدود يومية قصوى لعدد الطلبات التي يمكنك تقديمها. ترتبط حدود الاستخدام الوحيدة بمنتجات "منصة خرائط Google"، الحد الأقصى لعدد الاستعلامات في الدقيقة (QPM).
بالنسبة إلى مصفوفة المسافة، يتم ضبط الحدّ الأقصى المسموح به في عدد الأحداث في الدقيقة (EPM) والذي يتم احتسابه كمجموع جانب العميل والخادم.
بالنسبة إلى "المسارات: احتساب مصفوفة المسارات"، يكون الحدّ الأقصى للعناصر في الدقيقة (EPM)، حيث يكون عدد العناصر في الطلب مساويًا: (عدد نقاط المصدر مضروبًا في عدد نقاط الوجهة).
بالنسبة إلى حِزم تطوير البرامج (SDK) لنظام التنقّل، يتم احتساب كل وجهة في طلب كطلب بحث منفصل.
يوضح الجدول التالي الحد الأقصى للاستخدام لكل واجهة برمجة تطبيقات.
واجهة برمجة التطبيقات الحدّ الأقصى للاستخدام التحقق من العنوان 6,000 ملف برمجي في الساعة Aerial View: Lookup Video 180 طلب بحث في الدقيقة و100,000 طلب بحث في اليوم عرض جوي: إنشاء فيديو 100 QPM و100 QPD جودة الهواء 6,000 QPM الاتجاهات 3,000 طلب في الدقيقة مصفوفة المسافة 60,000 EPM الخرائط الديناميكية 30,000 كيلوبايت في الثانية الارتفاع 6,000 QPM الترميز الجغرافي 3,000 وحدة QPM الموقع الجغرافي 6,000 ملف برمجي في الساعة واجهة برمجة تطبيقات "شاشات المعلومات": مربّعات ثنائية الأبعاد ومربّعات التجوّل الافتراضي 6,000 طلب بحث في الدقيقة و15,000 طلب بحث في اليوم واجهة برمجة التطبيقات Map Tiles API: الإطارات ذات الصور الواقعية ثلاثية الأبعاد 10,000 QPD واجهة برمجة تطبيقات "شاشات المعلومات": مربّعات ثلاثية الأبعاد ذات صور واقعية: العارض 12,000 QPM التنقل: ضبط طلبات الوجهة 30,000 وحدة QPM الأماكن 6,000 QPM لقَاح 6,000 ملف برمجي في الساعة الطرق 30,000 وحدة QPM المسارات: حوسبة المسارات 3,000 طلب في الدقيقة المسارات: مصفوفة مسارات الحوسبة 3,000 EPM الطاقة الشمسية 600 وحدة QPM خرائط ثابتة 30,000 وحدة QPM واجهة برمجة تطبيقات صور التجوّل الافتراضي 30,000 ملف برمجي في الساعة المنطقة الزمنية 30,000 وحدة QPM لإدارة الإنفاق، يمكنك مراقبة استخدام واجهة برمجة التطبيقات، وضبط حدود يومية لجميع الطلبات المرسَلة إلى أي واجهة برمجة تطبيقات تخضع للفوترة.
يجب نشر منتجات Google Maps Platform بما يتوافق مع بنود خدمة Google Maps Platform العادية.
- كيف يتم احتساب تكلفة الاستخدام؟
-
للحصول على نظرة عامة على أسعار منتجات Google Maps Platform، يُرجى الاطّلاع على جدول الأسعار.
للاطّلاع على مزيد من المعلومات عن كيفية فوترة واجهات برمجة التطبيقات في "منصة خرائط Google"، يُرجى الاطّلاع على مقالة التعرّف على الفوترة في واجهتَي برمجة التطبيقات Maps وRoutes وPlaces وEnvironment.
- كيف يتم احتساب عمليات تحميل الخرائط على "منصة خرائط Google"؟
-
يتم تحميل تحميل خريطة واحدة في حالة حدوث أي مما يلي:
- تعرِض صفحة ويب أو تطبيق خريطة باستخدام واجهة برمجة التطبيقات Maps JavaScript API.
- يطلب أحد التطبيقات صورة خريطة واحدة من واجهة برمجة التطبيقات Maps Static API.
يتم تحصيل رسوم بانوراما "التجوّل الافتراضي" بشكل منفصل عن عمليات تحميل الخرائط:
- يتم تحصيل رسوم مقابل بانوراما ثابتة في "التجوّل الافتراضي" مقابل كل طلب إلى واجهة برمجة التطبيقات لميزة "التجوّل الافتراضي" الثابتة لتضمين بانوراما ثابتة (غير تفاعلية) في "التجوّل الافتراضي".
- يتم تحصيل رسوم بانوراما ديناميكية في التجوّل الافتراضي مقابل كل مثيل كائن بانوراما في واجهة برمجة تطبيقات JavaScript للخرائط أو حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android أو حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" تطبيق iOS.
بعد أن تحمِّل صفحة ويب أو تطبيق خريطة أو صورة خريطة ثابتة أو صورة بانورامية في "التجوّل الافتراضي"، لا تؤدي أي تفاعلات للمستخدِم مع الخريطة، مثل التمرير أو التكبير أو التصغير أو تبديل طبقات الخريطة، إلى توليد عمليات تحميل إضافية للخريطة أو التأثير في حدود الاستخدام.
لن تؤدي إضافة مُحدد إلى إنشاء أحمال إضافية للخريطة، ولكن قد ينتج عنها تحصيل رسوم حول كيفية تحديد موقع الدبوس (مثل تحميل أو إعادة تحميل الفئة "google.maps.Map() ".)
- كيف يمكنني مراقبة معدّل الاستخدام؟
-
يمكنك مراقبة استخدام واجهات برمجة تطبيقات فردية في Google Cloud Console.
- اختَر المشروع الذي يحتوي على واجهة برمجة التطبيقات التي تريد مراجعتها.
- من قائمة واجهات برمجة التطبيقات في لوحة البيانات، انقر على اسم واجهة برمجة التطبيقات.
- بالقرب من أعلى الصفحة، انقر على المقاييس أو الحصص:
للاطّلاع على تقرير عن عدد الزيارات ومعلومات الفوترة لمشروع كامل، اتّبِع الخطوات التالية:
- عليك إعداد الفوترة إذا لم تكن قد فعلت ذلك من قبل.
- انتقِل إلى صفحة الفوترة في Cloud Console.
- اختَر مشروعًا.
- في الشريط الجانبي الأيمن، انقر على التقارير. استخدام الفلاتر على الشريط الجانبي الأيسر لعرض التقارير على حساب الفوترة
لمزيد من المعلومات، يمكنك الاطّلاع على تقارير "منصّة خرائط Google" ومراقبة استخدام واجهة برمجة التطبيقات ووضع حدود لاستخدام واجهة برمجة التطبيقات.
- ماذا يحدث إذا تجاوزت حدود معدّل الطلبات (الطلبات في الدقيقة)؟
-
في حال تجاوز حدود عدد عمليات البحث في الصفحة لمنتج معيّن في "منصّة خرائط Google"، ستعرض واجهة برمجة التطبيقات رسالة خطأ. إذا كنت تجاوز الحدود المسموح بها بشكل متكرر، فقد يتم إيقاف وصولك إلى واجهة برمجة التطبيقات مؤقتًا محظور.
في حال تجاوز حدود QPM للطلب أو وإلا، فإن الطلبات ستعرض رسالة خطأ محددة. إذا استمرّت في تجاوز الحدود، قد يتم حظر إمكانية وصولك إلى "منصة خرائط Google".
ملاحظة: تتوفّر خدمة مماثلة من جهة العميل في Maps JavaScript API لأربع واجهات برمجة تطبيقات لخدمة الويب: الاتجاهات وDistance Matrix وElevation وGeocoding.
تم تجاوز حدود الاستخدام
في حال تجاوزت حدود الاستخدام، ستتلقّى
OVER_QUERY_LIMIT
رمز حالة كردّ.تعني هذه الرسالة أنّ خدمة الويب توقّفت عن تقديم الردود العادية وانتقلت إلى عرض رمز الحالة
OVER_QUERY_LIMIT
فقط إلى أن يُسمح بمزيد من الاستخدام مرة أخرى. يمكن أن يحدث هذا السيناريو في غضون بضع ثوانٍ، إذا تم تحديد نظرًا لأن طلبك أرسل عددًا كبيرًا جدًا من الطلبات في الدقيقة.إذا كنت تتجاوز الحدود القصوى لاستخدام طلبات البحث في خرائط Google بشكل منتظم، ننصحك بخفض معدّل الاستخدام من خلال تحسين التطبيقات لاستخدام منتجات "منصّة خرائط Google" بفعالية أكبر، أو طلب زيادة حصتك. اطّلِع على دليل التحسين لمزيد من المعلومات.
- يتلقّى موقعي الإلكتروني عددًا كبيرًا من الزيارات. هل يمكنني استخدام منتجات "منصة خرائط Google"؟
-
نعم. ومع ذلك، ننصحك بالاطّلاع على حدود الاستخدام لأي من منصّة خرائط Google التي يعتمد عليها تطبيقك.
- إذا أصبح موقعي الإلكتروني أو تطبيقي رائجًا فجأةً، هل ستتوقف خرائطي؟ العمل؟
-
بعد أن يكون لديك حساب فوترة، إذا تجاوزت حد الاستخدام الشهري بدون رسوم والذي يبلغ 200 دولار أمريكي ولم يكن لديك طريقة دفع صالحة في حساب الفوترة (بطاقة الائتمان أو التحويل المصرفي أو غير ذلك)، سيتوقف واجهة برمجة التطبيقات عن العمل إلى أن تضيف طريقة دفع صالحة.
- كيف سيتم احتساب الاستخدام وإصدار الفواتير؟
-
يتم احتساب الاستخدام في نهاية كل يوم، ويتم تحديد سعره كما هو موضّح في جدول الأسعار. في نهاية كل شهر، يتم تحصيل إجمالي رسوم الاستخدام من طريقة الدفع المرتبطة بحساب الفوترة. لمزيد من المعلومات، يُرجى مراجعة الفوترة في "منصة خرائط Google":
- ما هي تكلفة استخدام "منصة خرائط Google"؟
-
اطّلِع على جدول الأسعار للحصول على نظرة عامة على التكلفة لكل واجهة برمجة تطبيقات. إذا كان تطبيقك يُنشئ طلبات أو أحجام تحميل خرائط تصل إلى 200 دولار أمريكي في الشهر ، لن يتم تحصيل رسوم منك مقابل الاستخدام. سيتم تحصيل الرسوم من حساب الفوترة مقابل الاستخدام الذي يتجاوز الرصيد الشهري الذي تبلغ قيمته 200 دولار أمريكي. لمزيد من التفاصيل، يُرجى الاطّلاع على دليل فهم الفوترة في Google Maps Platform.
- هل تتوفّر الأسعار بعملات أخرى؟
-
قد تتوفّر عملات إضافية في وحدة التحكّم. عند اختيار عملة مختلفة، سيتم تحويل الأسعار من القيمة المعادلة بالدولار الأمريكي المدرَجة في جدول الأسعار.
- لقد أعددت الفوترة. كيف يمكنني الاطّلاع على فاتورتي؟
-
تحصِّل Google منك في بداية كل شهر قيمة نشاطك، باستخدام طريقة الدفع المحددة. للاطّلاع على تفاصيل عن فاتورتك، يُرجى الاطّلاع على دليل فهم الفوترة في "منصّة خرائط Google".
معلومات إضافية:
- تعرَّف على كيفية عرض سجلّ التكاليف والدفعات
- كيفية الحصول على فاتورة أو إيصال دفع
- تعرَّف على كيفية ضبط تنبيهات الفوترة وإدارتها.
- كيف أتجنب دفع فاتورة كبيرة في حالة زيادة استخدامي بشكل غير متوقع؟
-
توفّر "منصة خرائط Google" طرقًا لضبط حدود الطلبات اليومية وضبط الحدود القصوى اليومية القابلة للفوترة. يمكنك تحديد الحد الأقصى اليومي للاستخدام للحماية من الزيادات غير المتوقعة. يمكنك أيضًا ضبط تنبيهات الميزانية على تلقي إشعارات عبر البريد الإلكتروني عندما تصل الرسوم في حساب الفوترة إلى الذي تضعه.
وضع حد أقصى يومي قابل للفوترة:
لتجنُّب تلقّي فاتورة كبيرة، يمكنك ضبط حدّ أقصى يومي للاستخدام للحماية من الارتفاعات غير المتوقّعة في الاستخدام. يمكنك تغيير هذا الحد في Cloud Console من خلال اتّباع الخطوات التالية:
- الانتقال إلى واجهات برمجة التطبيقات لوحة بيانات الخدمات:
- اختَر مشروعًا إذا طُلب منك ذلك.
- اختَر واجهة برمجة تطبيقات من القائمة، ثم انقر على علامة التبويب الحصص.
- انقر على رمز التعديل بجانب حصة "الطلبات في اليوم".
بدلاً من ذلك، يمكنك تعديل حصص متعددة لواجهات برمجة تطبيقات متعددة باستخدام إدارة الهوية وإمكانية الوصول لوحة بيانات الحصص للمشرف.
ضبط تنبيهات الميزانية وإدارتها:
إعداد تنبيهات بشأن الميزانية لإرسال إشعارات عبر البريد الإلكتروني إلى مشرفي الفوترة عندما تبلغ الرسوم في حساب الفوترة الحدّ الذي تحدّده سيتلقّى مشرفي الفوترة إشعارات عبر البريد الإلكتروني عندما تتجاوز الرسوم المقدَّرة في حساب الفوترة نسبة %50 و%90 و%100 من الحدّ الأقصى.
- تلقّيتُ رسالة تفيد بأنّ مشروعي مرتبط بمنصّة "خرائط Google". انتقالاً للحساب"، ولكن ليست لدي إمكانية الوصول إلى هذا الحساب. فماذا أفعل؟
-
تم إنشاء "حساب النقل إلى منصة خرائط Google" لمساعدة بعض العملاء على الانتقال إلى خطة الأسعار الجديدة "الدفع حسب الاستخدام". من خلال هذا الإجراء، تمكّنت Google من منح هؤلاء العملاء رصيدًا لمرة واحدة، وبالتالي تمكّنوا من مواصلة استخدام "منصة خرائط Google" بما يصل إلى الحد الأقصى لمستوى الاستخدام بدون رسوم الذي يبلغ 200 دولار أمريكي. بمجرد تجاوز هذا الحد، سيتم إيقاف حساب الفوترة ستفقد إمكانية الوصول إلى الخدمة. لتجنُّب انقطاع الخدمة، ننصح باتّباع الخطوات التالية: تعيين حساب الفوترة الخاص بك، والاستمرار في التمتع بقيمة 200 دولار (أو ما يعادلها بالعملة المحلية) شهريًا المجانية. لتغيير حساب الفوترة لمشروعك:
- إنشاء حساب فوترة جديد (إذا كان لديك حساب فوترة، يمكنك تخطّي هذه الخطوة).
- اربط حساب الفوترة بمشروعك.
- لماذا تم ضبط الحد الأقصى للحصة على طلب واحد في اليوم؟ كيف يمكنني رفع هذا الحدّ؟
-
في حال عدم إنشاء حساب فوترة وإرفاقه بمشروعك، ستلاحظ أنّ واجهات برمجة تطبيقات "منصة خرائط Google" سيقتصر على طلب واحد في اليوم. يمكنك الحصول على حصة أكبر من خلال إنشاء حساب فوترة وإرفاقه. ولإجراء ذلك، يُرجى الاطّلاع على بدء استخدام "منصة خرائط Google".
بمجرد إنشاء حساب فوترة وإرفاقه، سيبدأ حد حصتك اليومية . يمكنك تحديد تعيين لمنع الإنفاق غير المتوقع، في Cloud Console.
- تلقّيتُ إشعارًا بانتهاك سياسة الفوترة. كيف يمكنني حلّ هذه المشكلة؟
-
لقد تلقّيت هذا الإشعار لأنّ Google تبيّن لها أنّ حسابك يستخدم حسابات فوترة متعددة. ويشكّل ذلك انتهاكًا أحكام Google، على النحو المحدّد في الفقرة 3.2.4 من بنود خدمة "منصة خرائط Google". بموجب هذه البنود، لا يُسمح بإنشاء حسابات فوترة متعددة. لمزيد من المعلومات، يُرجى الاطّلاع على الأسئلة الشائعة حول الفوترة انتهاك الحساب.
استخدام "منصة خرائط Google"
- المفاتيح أو بيانات الاعتماد التي يجب أن أستخدمها لمختلف "خرائط Google" المنتجات؟
-
في كل مرة تستخدم فيها منتجات "منصة خرائط Google"، عليك تضمين واجهة برمجة تطبيقات. للتحقق من صحة طلبك. تتوفّر "منصّة خرائط Google" لتطبيقات Android أو iOS أو الويب، وعبر خدمات الويب HTTP.
مفتاح واجهة برمجة التطبيقات:
- مفتاح واجهة برمجة التطبيقات هو معرّف فريد يمكنك إنشاؤه باستخدام Cloud Console.
- مثال على تحميل واجهة برمجة تطبيقات تحتوي على مفتاح:
&key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo
التوقيع الرقمي:
- يتم إنشاء توقيع رقمي باستخدام سر توقيع عنوان URL تم توفيره لك من Google. يتم استخدام التوقيعات الرقمية مع Maps Static API و Street View Static API.
القيود:
- إنّ قيود مفتاح واجهة برمجة التطبيقات اختيارية، ولكننا ننصح بشدة بتقييد جميع مفاتيح واجهة برمجة التطبيقات. لتعزيز الأمان. عرض أفضل ممارسات أمان واجهة برمجة التطبيقات لمزيد من التفاصيل
- يمكنك إضافة قيد تطبيق إلى مفتاح واجهة برمجة التطبيقات.
بعد حظر مفتاح، لن يعمل إلا على الأنظمة الأساسية التي تتيح هذا النوع من الحظر.
تتوفّر أربعة أنواع من قيود التطبيقات. يمكن لواجهات برمجة التطبيقات التي تفرض نوع القيود نفسه
استخدام المفتاح المحظور نفسه.
- عناوين IP (للخوادم الفردية) - لاستخدامها مع واجهات برمجة تطبيقات خدمات الويب
- مُحيلو HTTP (مواقع الويب) - لاستخدامها مع واجهات برمجة تطبيقات الويب
- تقييد تطبيق Android (حسب اسم الحزمة ومعرف الجهاز) - للاستخدام مع حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android
- قيود تطبيقات iOS (حسب معرّف حزمة iOS) - للاستخدام مع حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS
- يمكنك أيضًا إضافة قيد على واجهة برمجة التطبيقات إلى مفتاح واجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى مراجعة الحصول على مفتاح واجهة برمجة تطبيقات وإضافته وتقييده
يشير الجدول أدناه إلى القيود المفروضة على المفتاح/المستندات المُعتمَدة والتطبيق لكل من Google Maps Platform API/SDK.
واجهة برمجة التطبيقات/حزمة تطوير البرامج (SDK) قيود بيانات الاعتماد والتطبيقات حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android مفتاح واجهة برمجة التطبيقات مع تقييد Android1 حزمة تطوير برامج "الأماكن" لأجهزة Android مفتاح واجهة برمجة التطبيقات مع تقييد Android1 حزمة تطوير البرامج للتنقّل على Android مفتاح واجهة برمجة التطبيقات مع تقييد Android1 حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS مفتاح واجهة برمجة التطبيقات مع تقييد iOS1 حزمة تطوير برامج "الأماكن" لأجهزة iOS مفتاح واجهة برمجة التطبيقات مع تقييد iOS1 حزمة تطوير البرامج للتنقّل لنظام التشغيل iOS مفتاح واجهة برمجة تطبيقات مع قيود على نظام التشغيل iOS1 Maps JavaScript API مفتاح واجهة برمجة التطبيقات مع فرض قيود على مُحيل HTTP1 واجهة برمجة التطبيقات Map Tiles API مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1 واجهة برمجة تطبيقات مجموعات بيانات "خرائط Google" الرمز المميّز لبروتوكول OAuth Aerial View API مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1 واجهة برمجة التطبيقات الثابتة في "خرائط Google" مفتاح واجهة برمجة التطبيقات مع تقييد المُحيل HTTP1 + توقيع رقمي2 واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" مفتاح واجهة برمجة التطبيقات مع فرض قيود على مُحيل HTTP1 + التوقيع الرقمي2 Maps Embed API مفتاح واجهة برمجة التطبيقات مع فرض قيود على مُحيل HTTP1 Address Validation API مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1 Directions API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1 واجهة برمجة التطبيقات لمصفوفة المسافة مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1 Elevation API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1 Geocoding API مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1 واجهة برمجة التطبيقات لرصد الموقع الجغرافي مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1 واجهة Places API مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1 واجهة برمجة التطبيقات للطرق مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1 واجهة Routes API مفتاح واجهة برمجة التطبيقات مع فرض قيود على عنوان IP 1 واجهة برمجة تطبيقات المنطقة الزمنية مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1 Air Quality API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1 واجهة برمجة تطبيقات Pollen مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1 Solar API مفتاح واجهة برمجة التطبيقات مع تقييد عنوان IP1 1 القيود المفروضة على مفتاح واجهة برمجة التطبيقات اختيارية، ولكننا ننصح بشدة بتقييد جميع مفاتيح واجهة برمجة التطبيقات لمزيد من الأمان.2 استنادًا إلى الاستخدام، قد يكون مطلوبًا استخدام توقيع رقمي في Maps Static API وStreet View Static API. بغض النظر عن طريقة الاستخدام، ننصحك بشدة باستخدام مفتاح واجهة برمجة التطبيقات وتوقيع رقمي لمصادقة طلباتك. - كيف يمكنني تبديل نوع القيود المفروضة على المفتاح من مُحيل HTTP إلى قيد عنوان IP؟
-
ملاحظة مهمة: إذا كنت تستخدم أيًا من واجهات برمجة تطبيقات خدمات الويب مع مفتاح واجهة برمجة تطبيقات يتضمّن قيودًا على المُحيل، ستتعذّر طلباتك وستظهر رسالة الخطأ: "لا يمكن أن تتضمّن مفاتيح واجهة برمجة التطبيقات قيودًا على المُحيل عند استخدامها مع واجهة برمجة التطبيقات هذه". عليك التبديل إلى استخدام مفتاح واجهة برمجة التطبيقات مع قيود عناوين IP.
قبل تبديل نوع تقييد مفتاح واجهة برمجة التطبيقات من مُحيل HTTP إلى IP تأكد من أن جميع واجهات برمجة التطبيقات التي تستخدم مفتاح واجهة برمجة التطبيقات تتوافق مع عنوان IP نوع القيود. يمكن لواجهات برمجة التطبيقات من نوع القيود نفسه أن تستخدم نفس القيود المفتاح. إذا أردت فرض أكثر من قيد واحد، عليك إضافة مفتاح منفصل. مع فرض القيود المطلوبة. تعرّف على كيفية إضافة مفتاح واجهة برمجة التطبيقات.
مزيد من المعلومات حول مفتاح واجهة برمجة التطبيقات القيود المرتبطة بمنتجات "منصة خرائط Google".
لتبديل مفتاح واجهة برمجة تطبيقات مع تقييد المُحيل HTTP إلى تقييد عنوان IP، اتّبِع الخطوات التالية:
- انتقِل إلى صفحة "بيانات الاعتماد" في Cloud Console.
- اختَر المشروع الذي يحتوي على مفتاح واجهة برمجة التطبيقات الذي تريد تعديله.
- في صفحة بيانات الاعتماد، اختَر اسم مفتاح واجهة برمجة التطبيقات من قائمة مفاتيح واجهة برمجة التطبيقات لتعديل تفاصيل المفتاح.
- في قسم قيود المفاتيح في الصفحة، اختَر "عناوين IP (خوادم الويب ووظائف cron وغيرها)" وأدخِل عناوين IP المناسبة للخادم، ثم انقر على "حفظ".
- كيف يمكنني الحصول على مفتاح واجهة برمجة تطبيقات جديد؟
- اطّلع على بدء استخدام "منصة خرائط Google".
- كيف يمكنني العثور على التغييرات التي تم إدخالها في كل إصدار من واجهات برمجة تطبيقات "خرائط Google"؟
-
تتوفر معلومات تغيير الإصدار للعديد من واجهات برمجة تطبيقات الخرائط على الروابط التالية:
- واجهة برمجة تطبيقات JavaScript في خرائط Google
- Routes API
- Directions API
- Distance Matrix API
- حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android
- حزمة تطوير برامج "الأماكن" لأجهزة Android
- حزمة تطوير البرامج للتنقّل على Android
- حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS
- حزمة تطوير برامج "الأماكن" لأجهزة iOS
- حزمة SDK للتنقل لنظام التشغيل iOS
- Address Validation API
- Aerial View API
- Air Quality API
- واجهة برمجة تطبيقات Pollen
- Solar API
- Map Tiles API
- Maps Datasets API
يمكنك أيضًا التحقّق من إصدار Google Maps Platform الذي تم فيه تسجيل خطأ معيّن وإصلاحه باستخدام أداة تتبُّع المشاكل في Google Maps Platform على الرابط التالي:
- كيف يمكنني تحميل واجهة برمجة التطبيقات في إحدى الصفحات بشكل غير متزامن بعد تحميل الصفحة؟
-
ما عليك سوى تحديد مَعلمة ردّ الاتصال عند تحميل واجهة برمجة التطبيقات. مزيد من المعلومات ويمكنك العثور على الرمز النموذجي في الحصول على تم بدء الفصل من وثائق واجهة برمجة تطبيقات JavaScript للخرائط.
- كيف يمكنني عرض منتجات "منصة خرائط Google" بلغة أخرى غير الإنجليزية؟
-
ستحاول واجهة برمجة التطبيقات تلقائيًا تحميل أنسب لغة استنادًا إلى إعدادات الموقع أو المتصفح للمستخدمين. تتيح لك بعض واجهات برمجة التطبيقات إعداد اللغة عند تقديم طلب. يمكنك الاطّلاع على مزيد من المعلومات عن كيفية ضبط اللغة في مستندات كل واجهة برمجة تطبيقات:
- واجهة برمجة تطبيقات JavaScript للخرائط
- Geocoding API
- Routes API
- Directions API
- واجهة برمجة التطبيقات لمصفوفة المسافة
- Places API
- Maps Static API
غالبًا ما تعدّل 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 Maps Platform عبر طبقة المقابس الآمنة (HTTPS)؟
-
يمكن الوصول إلى واجهة برمجة التطبيقات JavaScript لخرائط Google وواجهة برمجة التطبيقات الثابتة لخرائط Google وواجهات برمجة تطبيقات خدمات الويب عبر اتصالات آمنة (HTTPS). يُرجى الاطّلاع على وثائق واجهة برمجة التطبيقات المعنية للحصول على معلومات حول كيفية الدخول إلى واجهة برمجة التطبيقات عبر طبقة المقابس الآمنة.
تجدر الإشارة إلى أنّ واجهة برمجة التطبيقات Maps Static API لا تتيح استخدام عناوين URL مخصّصة للرمز تستخدِم بروتوكول HTTPS، وسيتم عرض الرمز التلقائي.
- كيف يمكنني الإبلاغ عن خطأ أو طلب ميزة جديدة في "منصة خرائط Google"؟
-
إذا واجهت سلوكًا تعتقد أنّه قد يكون خطأ، يُرجى أولاً الإبلاغ عنه في المنتدى ذي الصلة. سيؤدي هذا إلى السماح للمطوّرين الآخرين بالتحقق من الخطأ واستبعاد أي مشاكل محتملة باستخدام التعليمات البرمجية.
إذا أردت طلب ميزة، يُرجى أيضًا طرحها أولاً في المنتدى ذي الصلة للتأكّد من أنّه ليس متوفّرًا حلّ يلبي متطلباتك.
بعد تأكيد اكتشاف خطأ جديد أو من خلال الوظيفة الحالية في "منصة خرائط Google" المنتجات، يُرجى الإبلاغ عن خطأ أو طلب ميزة باستخدام أداة تتبُّع المشاكل في "منصة خرائط Google"
قبل إضافة خطأ أو طلب ميزة إلى أداة تتبُّع المشاكل، يُرجى التأكّد من أنّه لم يتمّ إضافة الخطأ أو الميزة المعنيّة من قبل. إذا حدث ذلك، يمكنك تمييز المشكلة بنجمة لتسجيل اهتمامك وتلقي إشعارات بالتحديثات.
-
تستخدِم حِزم تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظامَي التشغيل Android وiOS ملفات تعريف الارتباط بموجب سياسة خصوصية Google، مثل احتساب عدد المستخدمين النشطين يوميًا وخلال آخر 7 أيام ومنع إساءة استخدام الخدمة. ملفات تعريف الارتباط هذه غير مرتبطة بأي تسجيل الدخول إلى حساب Google وعدم تسجيل باقي المعلومات التي تم جمعها من طلبات بيانات من واجهة برمجة التطبيقات
- لا يمكنني العثور على إجابة عن سؤالي. ما هي الجهة التي يمكنني التواصل معها؟
-
يحافظ فريق علاقات المطوّرين في Google على حضور على Stack Overflow، وهو موقع الأسئلة والأجوبة التي يتم تعديلها بشكل تعاوني للمبرمجين. إنها مكانًا رائعًا لطرح الأسئلة الفنية حول تطوير تطبيقات خرائط Google. مزيد من المعلومات حول طرح الأسئلة على Stack يتوفر القائمة الكاملة في صفحة الدعم.
للحصول على أفضل النتائج عند طلب المساعدة، يُرجى مراعاة ما يلي:
- البحث في المناقشات الحالية من المحتمل أن شخصًا آخر قد تعرض مشكلة مشابهة وعثرت على حل.
- أرسِل رابطًا إلى موقعك الإلكتروني إن أمكن. لا تنشر مقتطفات الرموز البريدية إلا إذا كان الرمز غير مرئي بسهولة على الإنترنت.
- يُرجى تقديم جميع المعلومات ذات الصلة، بما في ذلك إصدارات المتصفّح والأخطاء وكلّ الحقائق الأخرى التي قد تكون مفيدة في تحديد هذه المشكلة وحلّها.
الأخطاء وتحديد المشاكل وحلّها
- ما هو معنى هذا الخطأ؟
-
إذا حدث خطأ أثناء تحميل أو تشغيل واجهات برمجة التطبيقات لخرائط Google، يُرجى مراجعة الروابط التالية للعثور على تفسيرات لرموز الخطأ:
- واجهة برمجة تطبيقات JavaScript للخرائط
- واجهة برمجة التطبيقات الثابتة في "خرائط Google"
- Maps Datasets API
- واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي"
- Maps Embed API
- Elevation API
- Geocoding API
- واجهة برمجة التطبيقات لرصد الموقع الجغرافي
- Routes API
- Directions API
- واجهة برمجة التطبيقات لمصفوفة المسافة
- Roads API
- Time Zone API
- Places API
- Address Validation API
- تظهر خرائطي أغمق من المعتاد. ماذا يحدث؟
-
في ظل ظروف معينة، تظهر خريطة مظلمة أو "سلبية" صورة "التجوّل الافتراضي" المميزة بعلامة مائية مع النص "لأغراض التطوير فقط" قد يتم عرضها. يشير هذا السلوك عادةً إلى مشاكل في مفتاح واجهة برمجة التطبيقات أو الفوترة. لاستخدام منتجات Google Maps Platform، يجب أن يكون لديك حساب فوترة وأن تتضمّن جميع الطلبات مفتاح واجهة برمجة تطبيقات صالحًا. ستساعدك الخطوات التالية في تحديد المشاكل وحلّها:
-
كيف يمكنني معالجة رمزَي الخطأ:
OVER_DAILY_LIMIT
أوOVER_QUERY_LIMIT
؟ -
يمكن عرض رموز الخطأ هذه لأيٍّ من الأسباب التالية:
- عدم توفُّر مفتاح واجهة برمجة التطبيقات في الطلب
- مفتاح واجهة برمجة التطبيقات المقدَّم غير صالح.
- لم يتم إرفاق حساب فوترة بالمشروع.
- وتم تجاوز الحد الأقصى للاستخدام الذي تفرضه المؤسسة نفسها.
- لم تعُد طريقة الدفع المقدّمة صالحة (على سبيل المثال، انتهاء صلاحية بطاقة الائتمان).
- تجاوزت حدود الحصة لواجهة برمجة تطبيقات معيّنة.
لاستخدام منتجات "منصة خرائط Google"، يجب أن يكون لديك حساب فوترة، كما يجب أن أن تتضمن الطلبات مفتاح واجهة برمجة تطبيقات صالحًا. لحلّ هذه المشكلة، اتّبِع الخطوات التالية:
- إعداد حساب فوترة
- احصل على مفتاح واجهة برمجة تطبيقات جديد.
- عدِّل الحد الأقصى المسموح به للاستخدام لزيادة الحد اليومي (إن أمكن).
-
كيف يمكنني معالجة رمزَي الخطأ:
kGMSPlacesRateLimitExceeded
أو9005 PLACES_API_RATE_LIMIT_EXCEEDED
؟ -
إذا ظهر لك الخطأ
kGMSPlacesRateLimitExceeded
أو9005 PLACES_API_RATE_LIMIT_EXCEEDED
، قد يعني ذلك أنّك تستخدم إصدارًا قديمًا من حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل Android أو حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS. يمكنك الاطّلاع على مزيد من المعلومات والعثور على حِزم SDK الجديدة على الرابط https://goo.gle/places-sdk-deprecation. - كيف يمكنني حل الخطأ: "عنوان IP هذا أو الموقع أو تطبيق الأجهزة الجوّالة ليس مخول باستخدام مفتاح واجهة برمجة التطبيقات هذا".
-
هناك سيناريوهات مختلفة قد تتسبب في حدوث هذا الخطأ:
- فعّلت قيود عنوان IP (الخادم) على مفتاح واجهة برمجة التطبيقات، ويحاول عنوان IP غير المصرّح به إرسال طلب.
- فعّلت قيود مُحيل HTTP (الموقع الإلكتروني) على مفتاح واجهة برمجة التطبيقات، ويحاول مُحيل غير مصرّح به إرسال طلب.
- لقد حظرت استخدام تطبيقات Android من خلال ضبط اسم الحزمة وبصمة إصبعها وتطبيق Android غير مصرّح به يحاول أحد الطلبات.
- لقد حظرت الطلبات الواردة من تطبيقات iOS من خلال تحديد معرّفات الحِزم، ويحاول تطبيق iOS غير المعروف إرسال طلب.
- كان من الممكن ظهور هذا الخطأ في السابق إذا كنت تستخدم أيًا من واجهات برمجة تطبيقات خدمات الويب، مع مفتاح واجهة برمجة تطبيقات يتضمّن قيودًا على مُحيل HTTP. الطلبات المُرسَلة إلى واجهات برمجة التطبيقات هذه باستخدام مفتاح واجهة برمجة تطبيقات مع عنوان IP. القيود. بدِّل نوع القيود المفروضة على المفتاح من قيد على مُحيل HTTP إلى قيد على عنوان IP. لمزيد من المعلومات عن تقييد مفاتيح واجهة برمجة التطبيقات، يمكنك الاطّلاع على أفضل الممارسات المتعلقة بمفتاح واجهة برمجة التطبيقات
عرض بيانات اعتماد مفتاح واجهة برمجة التطبيقات وتعديلها
لعرض مفاتيح واجهة برمجة التطبيقات وإدارة أي قيود، يمكنك اتّباع الخطوات التالية:
- انتقِل إلى صفحة "بيانات الاعتماد" في Cloud Console.
- اختَر المشروع الذي يحتوي على مفتاح واجهة برمجة التطبيقات الذي تريد مراجعته.
- للاطّلاع على تفاصيل بيانات الاعتماد، بما في ذلك أي قيود تم ضبطها للمفتاح، انقر على اسم المفتاح من قائمة مفاتيح واجهة برمجة التطبيقات.
- يتم عرض بيانات الاعتماد الكاملة لمفتاح واجهة برمجة التطبيقات المحدّد، بما في ذلك وأي قيود مفروضة على المفتاح. من هنا، يمكن أن تكون القيود تغييرها أو حذفها أو تحديثها حسب الحاجة.
- كيف يمكنني حلّ الخطأ "لا يمكن استخدام مفاتيح واجهة برمجة التطبيقات التي تتضمّن قيودًا على المُحيل مع واجهة برمجة التطبيقات هذه"؟
-
أنت تستخدم أيًا من واجهات برمجة تطبيقات خدمات الويب باستخدام مفتاح واجهة برمجة تطبيقات مقيد بمرجع HTTP. لأسباب تتعلق بالأمان، لا يمكن لخدمة الويب يجب أن تستخدم واجهات برمجة التطبيقات مفاتيح واجهة برمجة تطبيقات مقصورة على عناوين IP. بدِّل نوع القيود المفروضة على المفتاح من قيد مُحيل HTTP إلى قيد عنوان IP، أو أنشئ مفتاح واجهة برمجة تطبيقات جديدًا إذا سبق استخدام المفتاح مع واجهة برمجة التطبيقات JavaScript API في "خرائط Google".
خدمات "منصة خرائط Google"
- أحتاج إلى تحويل العناوين إلى أزواج من خطوط العرض/خطوط الطول. هل يمكنني فعل ذلك باستخدام منصة خرائط Google؟
-
نعم، تُعرف هذه العملية باسم "ترميز جغرافي". تتضمن واجهة برمجة تطبيقات JavaScript للخرائط فئة لأداء خدمة الترميز الجغرافي. الفئة هي: google.maps.Geocoder.
بدلاً من ذلك، توفر Google أيضًا Geocoding API التي توفر واجهة REST يمكنها الاستجابة بتنسيقات JSON وXML.
- ما هي البلدان التي تتوفّر فيها ميزة ترميز المواقع الجغرافية؟
-
للاطّلاع على البلدان التي تتوفّر فيها حاليًا خدمات "منصة خرائط Google" لتحديد المواقع الجغرافية، يُرجى الرجوع إلى بيانات تغطية "خرائط Google".
قد تختلف دقة المواقع الجغرافية المشفَّرة جغرافيًا حسب البلد، لذا عليك استخدام الحقل المعروض location_type لتحديد ما إذا تم العثور على مطابقة جيدة بما يكفي لأغراض تطبيقك. يُرجى ملاحظة أن توافر تعتمد بيانات الترميز الجغرافي على عقودنا مع مزودي البيانات، لذلك فهي تخضع للتغيير.
- لماذا توفِّر برامج الترميز الجغرافي في "منصة خرائط Google" مواقع جغرافية مختلفة عن المواقع الجغرافية التي توفّرها Google خرائط Google؟
-
أحيانًا يستخدم برنامج الترميز الجغرافي لواجهة برمجة التطبيقات وأداة الترميز الجغرافي في "خرائط Google" مجموعات بيانات مختلفة. (حسب البلد). يتمّ تعديل ترميز الموقع الجغرافي لواجهة برمجة التطبيقات من حين لآخر باستخدام بيانات جديدة، لذا يمكنك توقّع رؤية تغييرات في النتائج أو تحسينها بمرور الوقت.
- كيف يمكنني تنسيق طلبات رمز الموقع الجغرافي لزيادة عدد الطلبات الناجحة إلى أقصى حدّ؟
-
تم تصميم أداة الترميز الجغرافي لتعيين عناوين الشوارع إلى الإحداثيات الجغرافية. ولذلك نوصي بتنسيق طلبات أداة الترميز الجغرافي وفقًا اتّباع الإرشادات التالية لزيادة احتمالية نجاح طلب البحث إلى أقصى حدّ:
- حدِّد العناوين وفقًا للتنسيق المستخدَم في الرمز البريدي الوطني. خدمة البلد المعني.
-
لا تحدِّد عناصر عنوان إضافية، مثل أسماء الأنشطة التجارية أو أرقام الوحدات
أو أرقام الطوابق أو أرقام الشقق التي لا يتم تضمينها في
العنوان على النحو المحدّد من قِبل الخدمة البريدية في البلد المعني.
وقد يؤدي ذلك إلى الحصول على ردود تتضمن
ZERO_RESULTS
. -
يجب تنسيق رموز Plus كما هو موضّح هنا (يتم ترميز علامات الجمع في عنوان URL لتكون
%2B
ويتم ترميز المسافات في عنوان URL لتكون%20
):- الرمز العالمي هو رمز منطقة مكوّن من 4 أحرف و6 أحرف أو أكثر.
الرمز المحلي (849VCWC8+R9 هو
849VCWC8%2BR9
). - الرمز المركب هو رمز محلي مكوَّن من 6 أحرف أو أكثر،
الموقع الجغرافي الفاضح (CWC8+R9 Mountain View، كاليفورنيا، الولايات المتحدة الأمريكية هو
CWC8%2BR9%20Mountain%20View%20CA%20USA
).
- الرمز العالمي هو رمز منطقة مكوّن من 4 أحرف و6 أحرف أو أكثر.
الرمز المحلي (849VCWC8+R9 هو
- استخدم رقم الشارع للمباني في أفضلية اسم المبنى حيث ممكن.
- استخدم عنونة أرقام الشوارع بالتفضيل لتحديد الشوارع المتقاطعة حيث ممكن.
- لا تقدِّم "تلميحات"، مثل المعالم المجاورة.
- كيف يمكنني تنسيق عنوان في الولايات المتحدة على طريق سريع مرقم لاستخدام الترميز الجغرافي؟
-
يتطلب ترميز المواقع الجغرافية في "منصة خرائط 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"؟
-
تتيح لك خدمة احتساب المسارات في Routes API وDirections API تقديم اتجاهات القيادة لرحلات فردية ورحلات تتضمّن عدّة مراحل. تساعدك خيارات التوجيه في تشكيل الاتجاهات مع وضع السفر (القيادة)، ومسارات واحدة أو مجموعة من المسارات، والقيود (بدون رسوم العبور). تتوفّر هذه الخدمات بالأشكال التالية:
- واجهة طلب/استجابة HTTP (المستخدَمة في التطبيقات المتوافقة مع الأجهزة الجوّالة والتطبيقات الأخرى) متوافقة مع حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android وخدمات الويب الأخرى في "خرائط Google".
- JavaScript API للتطبيقات من جهة العميل تتيح لك توفير اتجاهات القيادة عبر google.maps.DirectionsService. تشير رسالة الأشكال البيانية DirectionsRenderer صف يمكنه إنشاء التراكبات ولوحة الاتجاهات تلقائيًا لك. تقدّم المستندات أمثلة إضافية.
- واجهات عميل Java وPython وgo وNode.js، للتطبيقات من جهة الخادم، تقدم نفس الوظيفة. لمزيد من المعلومات عن مكتبات العملاء، يُرجى الاطّلاع على مكتبات عملاء Directions API.
- ما هي البلدان التي تتوفّر فيها اتجاهات القيادة؟
-
للاطّلاع على البلدان المتاحة حاليًا من خلال اتجاهات القيادة في منتجات "منصة خرائط Google"، راجِع بيانات تغطية "خرائط Google". يُرجى العِلم أنّ توفّر بيانات اتجاهات القيادة يعتمد على عقودنا مع موفّري البيانات، وهو يخضع للتغيير.
- ما هي البلدان التي تتوفّر فيها اتجاهات النقل العام؟
-
تتيح كل من Directions API و Distance Matrix API لجميع شركاء Google Transit، باستثناء الشركاء في اليابان.
- ما ميزات KML وGeoRSS المتوافقة في واجهة برمجة تطبيقات JavaScript للخرائط؟
-
تشير رسالة الأشكال البيانية KmlLayer في واجهة برمجة تطبيقات JavaScript للخرائط تمكن المطورين من تركيب ملفات KML/KMZ ملفات GeoRSS أعلى الخريطة. يمكنك الاطّلاع على المستندات والأمثلة هنا.
- ما هي الحدود المفروضة على حجم ملفات KML وتعقيدها والتي يمكن عرضها باستخدام فئة KmlLayer من Maps JavaScript API؟
-
حدود الحجم والتعقيد على عرض KML باستخدام تم توثيق صف واحد (
KmlLayer
). هنا. - كيف أعرض ملفات KML المستضافة على شبكة إنترانت؟ مواقع الويب على الخريطة؟
-
فئة
KmlLayer
التي تُنشئ تراكبات KML في Maps JavaScript API تستخدِم خدمة مستضافة على Google لاسترداد ملفات KML و تحليلها لعرضها. نتيجةً لذلك، لا يمكن عرض ملفّات KML التي لا تكون مستضافة على عنوان URL متاح للجميع أو التي تتطلّب مصادقة للوصول إليها.إذا كنت بحاجة إلى تطوير تطبيقات تستخدم ملفات KML المستضافة على شبكة إنترانت نقترح عرض ملف KML من جانب العميل باستخدام ومكتبات JavaScript التابعة لجهات خارجية. بما أنّ ملف KML يتم تحليله من قِبل المتصفّح، قد يكون الأداء أقل من استخدام فئة
KmlLayer
. - ما هو الحد الأقصى لعدد العلامات أو رؤوس المسارات التي تتوافق مع واجهة برمجة التطبيقات Maps Static API؟
-
ليس هناك حد لعدد العلامات أو رؤوس المسار التي تدعمها واجهة برمجة التطبيقات الثابتة للخرائط عند استخدام رموز مخصّصة، يمكن تحديد ما يصل إلى خمسة رموز فريدة لكل طلب، ولكن يمكن استخدام كل رمز عدة مرات في الخريطة.
يُرجى العلم أنّ عناوين URL لواجهة برمجة التطبيقات "الخرائط الثابتة" يمكن أن تحتوي على 8,192 حرفًا كحد أقصى، ما يحدّ من عدد العلامات ونقاط ملفّ المسار التي يمكن تحديدها استنادًا إلى عدد الأرقام العشرية المُستخدَمة عند تحديد كل زوج من خطوط الطول/العرض. للحصول على معلومات عن كيفية ارتباط عدد المواضع العشرية المستخدَمة بالدقة على سطح الأرض، يمكنك الاطّلاع على مقالة درجات Decimal في Wikipedia.
- لماذا لا يمكنني الوصول إلى منتجات "منصة خرائط Google" لبلدان معيَّنة؟
-
لا يجوز استخدام واجهات برمجة التطبيقات للخرائط في المناطق المحظورة. يُرجى الرجوع أيضًا إلى بنود الخدمة.
- كيف يمكنني الإبلاغ عن مشكلة في الخريطة الأساسية من Google؟
-
يمكنك إرسال ملاحظات من خلال "خرائط Google" عن معلومات الخريطة غير الصحيحة أو الناقصة، مثل:
- عناوين أو أماكن محدّدات مواقع خاطئة
- أسماء طرق غير صحيحة
- معلومات خاطئة عن الطرق الأحادية الاتجاه والطرق المزدوجة الاتجاه
- طريق مرسوم بشكل غير صحيح
- طرق مغلقة
- طرق غير موجودة
لتصحيح بطاقة بيانات مكان أو نشاط تجاري، يمكنك اقتراح تعديل.
إذا كان يجب إزالة محتوى "خرائط Google" لأسباب قانونية، يُرجى إرسال طلب قانوني.
بالنسبة إلى الطلبات المُهمّة أو الحساسة للوقت، يمكنك إرسال حالة دعم تتضمّن تفاصيل محدّدة عن ما يجب إصلاحه.
تمّ تجهيز بعض الميزات من جهة العميل للإبلاغ عن حالات النجاح أو التعذّر بغرض احتساب هدف مستوى الخدمة (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 لخرائط Google بعد تحميلها؟
-
يجب إعادة تحميل الصفحة التي تحمّل واجهة برمجة التطبيقات JavaScript خرائط Google مرة واحدة على الأقل كل 5 أيام.
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS
-
كيف يمكنني حلّ الخطأ:
kGMSPlacesRateLimitExceeded
؟ - إذا ظهر لك هذا الخطأ، من المحتمل أنّك تستخدم إصدارًا قديمًا من حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" على نظام التشغيل iOS. يتضمن الإصدار 2.7.0 من حزمة تطوير برامج الأماكن لأجهزة iOS تم إيقافها ولم تعد متوفرة. يُرجى تحديث تطبيقك لاستخدام أحدث إصدار في أقرب وقت ممكن. يُرجى الاطّلاع على دليل نقل البيانات. لمزيد من التفاصيل.
- تحدث لي أعطال عند تصحيح الأخطاء باستخدام جهاز iOS 8.x. ماذا يجب أن أفعل؟
-
إذا كنت تواجه مشاكل عند تصحيح الأخطاء على الأجهزة التي تعمل بالإصدار iOS 8.x، اتّبِع الخطوات التالية: الخطوات التالية لإيقاف التقاط إطار وحدة معالجة الرسومات في مخطَّط XCode الذي تستخدمه:
- في XCode، اختَر المنتج أو المخطط أو إدارة المخططات.
- حدد مخططًا واختر تعديل....
- اضبط خيار التقاط إطار وحدة معالجة الرسومات على غير مفعَّل. لاحظ أن هذا قد لا يكون الخيار متاحًا في جميع الأجهزة.
- ما هو تأثير الشاشات المستديرة والأوسع على حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" على نظام التشغيل iOS؟
-
بدءًا من هاتف iPhone X، تتميز هواتف iPhone بشاشة ذات زوايا مُستديرة وشق في أعلى الشاشة لبيت الاستشعار بالجهاز، ومُؤشر في أسفل الشاشة للوصول إلى الشاشة الرئيسية. اعتبارًا من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS 11.0، أضافت Apple واجهة برمجة التطبيقات Safe Area API التي تتيح للمطوّرين وضع العناصر في منطقة آمنة من القطع بسبب شكل الشاشة الجديد.
تحتوي حزمة تطوير البرامج (SDK) لنظام التشغيل iOS في "خرائط Google" على العديد من العناصر المرئية وعناصر التحكّم، مثل أداة الاختيار الداخلية ورابط الإبلاغ عن مشكلة. في الإصدار 2.4، يمكن أن يتم اقتصاص هذه العناصر المرئية وعناصر التحكّم من خلال شكل الشاشة الجديد. في الوضع المُعدّ للعرض على الشاشة العريضة، قد يتم اقتصاص أداة اختيار الأرضية الداخلية إما من خلال الشاشة المُثقوبة أو مؤشر زر الشاشة الرئيسية.
تم إصلاح مشكلات التنسيق هذه مع الإصدار 2.5 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS في خرائط Google تلقائيًا. عند استخدام تطبيقك على هاتف iPhone X أو إصدار أحدث، تزداد المساحة المتروكة في GMSMapView وGMSPanoramaView. بحيث لا يتم اقتصاص العناصر المرئية.
سنضمّن تلقائيًا دائمًا الحشو. حزمة تطوير البرامج (SDK) لنظام التشغيل iOS في "خرائط Google" أن المساحة المتروكة مخصصة للحشو من داخل المنطقة الآمنة. إذا كنت تصميم واجهتك بافتراض أن كل شيء موضوع داخل المنطقة الآمنة، فسينجح ذلك دون أي جهد إضافي.
إذا كنت قد صممت واجهة لا تعمل باستخدام واجهة أدخلنا خاصية جديدة في GMSMapView، تسمى paddingAdjustmentBehavior. تتيح لك أداة GMSMapView الآن الاختيار من بين أحد سلوكَي تعديل الحشوَين التاليَين: "دائمًا" (الإعداد التلقائي) و"تلقائي" و"أبدًا".
إذا تم ضبط GMSMapView لاستخدام سلوك الحشو "دائمًا"، سيتم دائمًا إضافة الأجزاء المضمّنة للمساحة الآمنة إلى الحشو. يتيح لك هذا تصميم مع افتراض أن جميع مواضع الإعلانات تقع من أطراف الخزنة واحدة. هذه هي القيمة الافتراضية.
إذا تم تعيين GMSMapView لاستخدام الحقل "تلقائي" سلوك المساحة المتروكة، سيتم دائمًا اختيار المساحة المتروكة الأكبر أو المساحة الداخلية الآمنة سيسمح لك هذا بإضافة مساحة متروكة من حافة الشاشة مع ضمان بقاء جميع العناصر داخل المنطقة الآمنة.
في حال ضبط GMSMapView على خيار "أبدًا" سلوك المساحة المتروكة، فلن تتم إضافة إدراجات المنطقة الآمنة في المساحة المتروكة. هذا هو السلوك السابق للإصدار 2.5 إصدار وقد يكون مفيدًا إذا كانت المساحة المتروكة تضع في الاعتبار المنطقة الآمنة، أو إذا كانت سلوكياتنا الأخرى لا تعمل بشكل جيد مع واجهتك. أنت المسؤول عن ضمان نشر شعار Google وإشعارات حقوق الطبع والنشر دائمًا مرئية، كما هو محدّد في منصة خرائط Google بنود الخدمة
في المقابل، لا تحتوي GMSPanoramaView على خاصية مساحة فارغة اختيارية. وهذا يعني أنّه ما مِن مساحة فارغة لتعديلها، وسيتم تطبيق GMSPanoramaView دائمًا على أي مساحة فارغة ضرورية لضمان أن تكون كل العناصر المرئية ضمن المنطقة الآمنة.
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android
-
كيف يمكنني حلّ الخطأ:
9005 PLACES_API_RATE_LIMIT_EXCEEDED
؟ - إذا ظهر لك هذا الخطأ، فربما تستخدم إصدارًا متوقفًا من حزمة تطوير برامج الأماكن لأجهزة Android تم إيقاف إصدار "خدمات Google Play" من حزمة تطوير برامج "الأماكن" لأجهزة Android، ولم يعُد متاحًا. يُرجى تحديث تطبيقك لاستخدام أحدث إصدار في أقرب وقت ممكن. يمكنك الاطّلاع على دليل نقل البيانات للاطّلاع على التفاصيل.
- لا يعرض تطبيقي سوى مربّعات فارغة باللون الرمادي بدلاً من خريطة. كيف يمكنني حلّ هذه المشكلة؟
-
من الأسباب الشائعة لظهور مربّعات رمادية فارغة بدلاً من الخريطة هي مشاكل المصادقة. يمكنك اتّباع الخطوات أدناه لتحديد هذه المشاكل وحلّها باستخدام adb Logcat.
- تأكّد من تثبيت adb. وإذا لم يكن الأمر كذلك، يمكنك اتّباع الخطوات الواردة في الدليل هنا.
- ثبِّت التطبيق الذي يعرض المشكلة على جهاز أو محاكي Android. وإذا كنت تستخدم محاكي Android، تأكَّد من تضمين "متجر Play" في إعدادات المحاكي.
- في وحدة تحكّم Android Studio، نفِّذ
adb logcat -e "Google Maps Android API"
. لن يتم طباعة سوى السطور التي تتطابق فيها رسالة السجلّ مع "Google Maps Android API". (يمكنك اختياريًا إخراج السجلّ إلى ملف نصي من خلال إلحاق: > logcat.txt) - أعِد عرض المشكلة على جهازك وتحقّق من الأخطاء الشائعة، مثل:
- يتمّ الإشارة إلى مفتاح واجهة برمجة التطبيقات غير الصحيح أو غير المقصود في ملف البيان.
- لم يتم تفعيل الفوترة في المشروع.
- لم يتم تفعيل حزمة تطوير البرامج (SDK) على واجهات برمجة تطبيقات المشروع.
- تتم إضافة بصمة SHA1 غير الصحيحة إلى قيود مفتاح واجهة برمجة التطبيقات.
- لم يتم تضمين ملحقات خدمة Google Play في ملف
build.gradle
.
توقيع عنوان URL
- هل يمكنني توقيع عناوين URL باستخدام JavaScript؟
-
ننصح بشدة بعدم توقيع عناوين URL باستخدام JavaScript لأنّ ذلك سيؤدي إلى الكشف عن سر توقيع عنوان URL للمستخدمين النهائيين. لذلك يجب أن تكون التوقيعات يتم إنشاؤها من خلال مكونات جانب الخادم فقط.
- لماذا أتلقّى استجابة HTTP 403 محظور لطلبات خدمة الويب في خرائط Google؟
-
تشير استجابة HTTP 403 إلى مشكلة في الإذن، ويعود السبب على الأرجح إلى عدم التمكّن من التحقّق من صحة التوقيع لهذا الطلب. قد يرجع السبب في ذلك إلى ما يلي:
- تم تحديد توقيع ولكنه غير صحيح لهذا الطلب.
- يحدّد الطلب مفتاح واجهة برمجة التطبيقات في خطة Google Maps Platform Premium ولكنه لا يحدّد توقيعًا، وتتطلّب الخدمة التي يتمّ استدعاؤها أن تتضمّن الطلبات التي يتمّ إجراؤها باستخدام مفتاح واجهة برمجة التطبيقات توقيعًا صالحًا.
- تم تحديد توقيع ولكن المرتبط لم يتم تحديد مفتاح واجهة برمجة التطبيقات للخطة المميزة في Google Maps Platform.