קבלת Maps Demo Key ושימוש בו עם Maps JavaScript API

‫Maps Demo Key היא תכונה חינמית שמאפשרת ליצור אב טיפוס באמצעות Maps JavaScript API בלי לציין פרטי חיוב. אפשר לאמת את הרעיונות ולראות אותם בפעולה לפני שמתחייבים לחשבון בתשלום. בדף הזה מוסבר איך פועל מפתח ההדגמה של Maps, מהן המכסות, באילו תכונות אפשר להשתמש ואיך מקבלים את המפתח ומשתמשים בו.

הערה: מפתח ההדגמה של Maps הוא למעשה מפתח API שתומך בקבוצה מוגבלת של תכונות. היא מיועדת למטרות בדיקה ויצירת אב טיפוס בלבד, ולא מיועדת לשימוש בסביבת ייצור. השימוש כפוף גם לתנאים ולהגבלות של פרויקט ההדגמה של מפות Google.

באילו תכונות אפשר להשתמש עם מפתח הדגמה של מפות?

מפתח ההדגמה של מפות Google תומך בקבוצה מוגבלת של תכונות מ-Maps JavaScript API ומ-Weather API. כדי להשתמש בממשקי API או בתכונות שלא מופיעים ברשימה שלמטה, צריך להוסיף חשבון לחיוב למפתח ההדגמה של Maps או ליצור מפתח API חדש ולהפעיל את החיוב. מידע נוסף מופיע במאמר בנושא הגדרת Maps JavaScript API.

תכונות נתמכות ב-Maps JavaScript API

‫✔ תכונות נתמכות

  • עיבוד מפה טעינת מפות דו-ממדיות ותלת-ממדיות עם תצוגות לוויין ושטח.
  • סמנים ואירועים הוספת סמנים, חלונות מידע וטיפול בקליקים של משתמשים.
  • עיצוב מפות החלת סגנונות JSON וערכות נושא מותאמות אישית על המפה.
  • ‫Places UI Kit רכיבים מוכנים מראש לחיפוש מקומות ולפרטים שלהם.
  • כלי שרטוט שרטוט צורות וקווי פוליגון להמחשת נתונים.

✘ תכונות שלא נתמכות

  • ‫Places API (חדש) שיטות חיפוש פרוגרמטיות כמו searchByText.
  • מסלולים וניווט שירות הכוונה וממשק Distance Matrix API.
  • Address Validation שירותים לתיקון כתובות ברמת דיוק גבוהה.

בנוסף לתכונות שצוינו למעלה, אפשר גם להשתמש במפתח ההדגמה של Maps עם Weather API. מידע נוסף זמין במאמר קבלת Maps Demo Key ושימוש בו עם Weather API.

מכסות של Maps Demo Key

המגבלות האלה יכולות להשתנות. אם תגיעו למכסה היומית, השימוש יושהה עד למחרת ולא תחויבו על כך.

איך משתמשים במפתח הדגמה של מפות

שלב 1: קבלת Maps Demo Key

כדי ליצור את המפתח, צריך לוודא שאתם מחוברים לחשבון Google שלכם וללחוץ על הלחצן Get a Demo Key (קבלת מפתח הדגמה). אחרי שתאשרו את התנאים של Maps Demo Key, המפתח יוצג ויהיה מוכן לשימוש באופן מיידי.

בנוסף, תקבלו אימייל עם הוראות לאחזור המפתח ממסוף Google Cloud.

שלב 2: שימוש במפתח הדגמה של מפות עם Maps JavaScript API

מבחינה טכנית, מפתח ההדגמה של Maps הוא מפתח API שתומך בקבוצה מוגבלת של תכונות. אתם יכולים להשתמש במפתח ההדגמה של מפות Google במקום במפתח API רגיל בכל אחת מהתכונות של Maps JavaScript API או Weather API שנתמכות. בדוגמה הבאה מוצג שימוש במפתח הדגמה של מפות עם מפה בסיסית. מחליפים את 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>

השלבים הבאים