الحصول على مفتاح 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 وMaps Grounding Lite. لاستخدام أي واجهة برمجة تطبيقات أو ميزة غير مُدرَجة أدناه، عليك إما إضافة حساب فوترة إلى مفتاح العرض التوضيحي في "خرائط Google" أو إنشاء مفتاح واجهة برمجة التطبيقات جديد وتفعيل الفوترة. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد Maps JavaScript API .

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

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

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

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

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

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

حصص Maps Demo Key

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

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

الخطوة 1: الحصول على Maps Demo Key

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

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

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

مفتاح العرض التوضيحي لـ Maps هو من الناحية الفنية مفتاح واجهة برمجة تطبيقات يتيح استخدام مجموعة محدودة من الميزات. يمكنك استخدام مفتاح 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>

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