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

منصة خرائط Google في AI Studio

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

من خلال دمج Maps Demo Key، يمكنك إنشاء نماذج أولية مستندة إلى الذكاء الاصطناعي قادرة على التعرّف على الموقع الجغرافي مباشرةً في AI Studio بدون الحاجة إلى إنشاء حساب فوترة على Google Cloud أو مغادرة سياق التطوير. إذا كنت تستخدم Google Cloud، يمكنك ربط مشروع تتم فوترته للوصول إلى جميع منتجات "منصة خرائط Google" بدون حدود يومية للحصص التجريبية، أو البدء باستخدام مفتاح تجريبي لـ "خرائط Google" وربط مشروع عندما تكون مستعدًا للتوسّع.

الميزات الأساسية

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

طرق للبدء

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

إذا كنت مستخدمًا جديدًا لـ Google Cloud: ينشئ AI Studio مشروعًا مجانيًا ومفتاحًا تجريبيًا لـ "خرائط Google" لمساعدتك في البدء.
مستخدمو Google Cloud الحاليون: يمكنك اختيار إنشاء نماذج أولية بدون تكلفة باستخدام مفتاح تجريبي لخدمة "خرائط Google" (مع مجموعة فرعية من واجهات برمجة التطبيقات وحدود الحصص اليومية) أو الحصول على إمكانية الوصول الكامل مع حصص على مستوى الإنتاج من خلال ربط مشروع حالي على Cloud تتم فوترته.

تخضع مفاتيح Maps Demo Keys لبنود خدمة Maps Demo Project.

الميزة	مستخدم جديد	مستخدم حالي (إنشاء نماذج أولية مجانًا)	مستخدم حالي (يربط مشروعًا على السحابة الإلكترونية يتم تحصيل رسوم عنه)
نوع بيانات الاعتماد	Maps Demo Key	Maps Demo Key	مفتاح Google Cloud API العادي
إعداد الفوترة	لا حاجة إلى بطاقة ائتمان أو حساب فوترة على Google Cloud	لا حاجة إلى بطاقة ائتمان أو حساب فوترة على Google Cloud	يتطلّب حساب فوترة على Google Cloud
تغطية واجهة برمجة التطبيقات	جميع واجهات برمجة التطبيقات في "منصة خرائط Google" (باستثناء Route Optimization وSolar وNav Connect)، بما في ذلك: Maps JavaScript API (بما في ذلك حزمة أدوات "خرائط Google" الجاهزة للأماكن) حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android وiOS Places API واجهة برمجة التطبيقات Routes API وCompute Routes Matrix Geocoding وGeolocation APIs Address Validation API Maps Static وStreet View Static APIs Air Quality API وPollen API وWeather API Aerial View API أدوات وكيل تجربة "خرائط Google"	واجهات برمجة التطبيقات الشائعة الاستخدام لإنشاء النماذج الأوّلية (يُرجى الاطّلاع على الميزات المتاحة): Maps JavaScript API (بما في ذلك حزمة أدوات "خرائط Google" الجاهزة للأماكن) Places API (باستثناء المحتوى من إنشاء المستخدمين، مثل الصور والمراجعات) واجهة برمجة التطبيقات Routes API وCompute Routes Matrix Geocoding API Weather API أدوات التجارب من "خرائط Google" للوكلاء	‫%100 من واجهات برمجة التطبيقات في "منصة خرائط Google" (بما في ذلك Route Optimization وSolar وNav Connect)
الحدود اليومية	‫100 طلب في اليوم لكل واجهة برمجة تطبيقات	‫100 طلب في اليوم لكل واجهة برمجة تطبيقات	الحصص العادية والاستخدام المجاني الشهري
القيود الرئيسية	إدارة الأسرار المبرمَجة أثناء سير العمل	إدارة الأسرار المبرمَجة أثناء سير العمل	قيود مخصّصة على مُحيل HTTP أو عنوان IP أو التطبيق
الاستخدام المقصود	إنشاء النماذج الأولية والاختبار وتطبيقات الويب في AI Studio	إنشاء النماذج الأولية والاختبار وتطبيقات الويب في AI Studio	تطبيقات الويب والأجهزة الجوّالة في مرحلة الإنتاج
مسار الإصدار العلني	ربط حساب فوترة على Cloud بالمشروع، وسيظل مفتاحك يعمل	ربط مشروع على Cloud يتم تحصيل رسوم عنه في AI Studio	جاهز للاستخدام في مرحلة الإنتاج

تحديد المشاكل وحلّها والحصص

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

أخطاء تجاوز الحصة المخصّصة

إذا تلقّى تطبيقك خطأ RESOURCE_EXHAUSTED أو خطأ تجاوز الحصة أثناء استخدام مفتاح تجريبي:

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

أخطاء عدم توفّر واجهة برمجة التطبيقات

إذا كنت من مستخدمي Google Cloud الحاليين الذين ينشئون نماذج أولية باستخدام Maps Demo Key، وتعذّر تنفيذ طلب بسبب خطأ في القيود المفروضة على مفتاح واجهة برمجة التطبيقات (على سبيل المثال، ApiTargetBlockedMapError في Maps JavaScript API)، يعني ذلك أنّ واجهة برمجة التطبيقات غير مضمّنة في قائمة واجهات برمجة التطبيقات المتوافقة مع هذا المفتاح. يجب ربط مشروع على السحابة الإلكترونية يتم تحصيل رسوم عنه لاستخدامه.

الترقية إلى مفتاح إنتاج

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

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