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

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

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

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

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

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

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

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

Maps JavaScript API

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

  • Maps Grounding Lite يمكنك ربط تطبيقات الذكاء الاصطناعي بالبيانات الجغرافية المكانية من "خرائط Google".
  • ‫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 مع Maps JavaScript API

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

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

<html>
<head>
  <title>Add a Map using HTML</title>
  <link rel="stylesheet" href="./style.css" />
  <script type="module" src="./index.js"></script>
</head>
<body>
  <gmp-map
    center="38.7946,-106.5348"
    zoom="4"
    map-id="DEMO_MAP_ID"
    style="height: 400px"
  >
  </gmp-map>
  <!--
    The `defer` attribute causes the script to execute after the full HTML
    document has been parsed. -->
  <script
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_DEMO_KEY&libraries=maps"
    defer
  ></script>
</body>
</html>

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