الحصول على مفتاح Maps Demo Key واستخدامه مع Weather API

‫Maps Demo Key هو ميزة مجانية تتيح لك بدء إنشاء نماذج أولية باستخدام "منصة خرائط Google" بدون إدخال معلومات الفوترة. يمكنك التحقّق من أفكارك ورؤيتها أثناء تنفيذها قبل الالتزام بحساب مدفوع. توضّح هذه الصفحة آلية عمل مفتاح العرض التوضيحي لخدمة "خرائط Google" والحصص والميزات التي يمكنك استخدامها وكيفية الحصول على المفتاح واستخدامه.

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

متطلبات الأهلية

للحصول على مفتاح Maps Demo، يجب استيفاء المتطلبات التالية:

  • نوع الحساب: يجب استخدام حساب Google شخصي (مثل عنوان @gmail.com). حسابات Google Workspace (الشركات) غير مؤهّلة.
  • الموقع الجغرافي: لا يتوفّر مفتاح Maps Demo Key في المناطق المحظورة. يتم تحديد أهليتك من خلال مجموعة من عنوان IP الحالي وموقع حسابك على Google.

ما هي الميزات التي يمكنني استخدامها مع مفتاح Maps Demo Key؟

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

Maps JavaScript API

واجهات برمجة تطبيقات خدمات الويب

  • أدوات تجربة الخرائط للوكلاء: تتيح لك هذه الأدوات ربط تطبيقات الذكاء الاصطناعي بالبيانات الجغرافية المكانية من "خرائط Google" (المعروفة سابقًا باسم Maps Grounding Lite).
  • ‫Places API (جديدة)*: تتيح لك الحصول على بيانات الموقع الجغرافي لملايين الأماكن حول العالم.
  • الإصدار 4 من Geocoding API: يتيح لك تحويل العناوين أو أرقام تعريف الأماكن إلى إحداثيات.
  • Compute Routes: تتيح لك الحصول على المسار المثالي بين موقعَين جغرافيَين.
  • ‫Weather API: تتيح الحصول على معلومات شاملة عن الطقس.

* لا يتوفّر المحتوى من إنشاء المستخدمين، مثل الصور والمراجعات التي يرسلها المستخدمون، من خلال Maps Demo Key.

حصص Maps Demo Key

يخضع مفتاح Maps Demo Key لحدود الاستخدام، والتي تخضع للتغيير. إذا بلغت الحدّ الأقصى اليومي، سيتم إيقاف استخدامك مؤقتًا حتى اليوم التالي بدون أي رسوم.

كيفية استخدام Maps Demo Key

الخطوة 1: الحصول على مفتاح Maps Demo

لإنشاء مفتاحك، تأكَّد من تسجيل الدخول باستخدام حسابك على Google واختَر الحصول على مفتاح تجريبي. بعد قبول بنود Maps Demo Key، سيتم عرض مفتاحك ليصبح جاهزًا للاستخدام على الفور.

ستصلك أيضًا رسالة إلكترونية تتضمّن تعليمات حول كيفية استرداد مفتاحك من وحدة تحكّم Google Cloud.

الخطوة 2: استخدام مفتاح Maps Demo Key مع Weather API

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

يوضّح المثال التالي كيفية استخدام Maps Demo Key مع طلب أساسي. استبدِل YOUR_DEMO_KEY بالمفتاح الذي استرددته للتو.

curl -X GET "https://weather.googleapis.com/v1/currentConditions:lookup?key=YOUR_DEMO_KEY&location.latitude=37.4220&location.longitude=-122.0841"

الخطوات التالية