קבלת מפתח הדגמה של מפות ושימוש בו עם Google Maps Platform

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

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

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

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

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

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

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

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

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

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

מכסות של Maps Demo Key

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

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

שלב 1: קבלת מפתח הדגמה של מפות

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

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

שלב 2: שימוש ב-Maps Demo Key עם Google Maps Platform

מבחינה טכנית, מפתח ההדגמה של 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>

השלבים הבאים