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

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

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

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

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

ميزات Maps JavaScript API المتاحة

✔ الميزات المتوافقة

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

✘ الميزات غير المتوافقة

  • Places API (الجديدة) طُرق البحث الآلية، مثل searchByText
  • المسارات والتنقّل خدمة الاتجاهات وDistance Matrix API
  • التحقّق من صحة العنوان خدمات تصحيح العناوين العالية الدقة:

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

حصص Maps Demo Key

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

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

الخطوة 1: الحصول على مفتاح العرض التوضيحي لخرائط Google

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

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

الخطوة 2: استخدام مفتاح العرض التوضيحي لخرائط Google مع Maps JavaScript API

مفتاح العرض التوضيحي لـ "خرائط Google" هو من الناحية الفنية مفتاح واجهة برمجة تطبيقات يتيح استخدام مجموعة محدودة من الميزات. يمكنك استخدام مفتاح Maps Demo Key بدلاً من مفتاح واجهة برمجة تطبيقات عادي في أي من ميزات Maps JavaScript API المتوافقة أو Weather API. يوضّح المثال التالي كيفية استخدام 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>

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