הודעה: בקרוב תהיה אפשרות להשתמש בסגנון חדש למפות הבסיס בפלטפורמה של מפות Google. העדכון הזה לסגנון המפה כולל ערכת צבעים חדשה שמוגדרת כברירת מחדל, סיכות מודרניות ושיפורים בחוויית השימוש במפה ובממשק שלה. כל סגנונות המפה יתעדכנו באופן אוטומטי במרץ 2025. מידע נוסף על הזמינות ועל האופן שבו אפשר להביע הסכמה מוקדם יותר זמין במאמר סגנון מפה חדש בפלטפורמה של מפות Google.

דף זה תורגם על ידי Cloud Translation API.

התחל בעבודה

בדף הזה מוסבר איך לקבל מפתח API, להפעיל את ממשקי ה-API הנדרשים ולטעון את ספריית המקומות, כדי שתוכלו לעבוד עם הכיתה Place.

קבלת מפתח API והפעלת ממשקי ה-API הנדרשים

לפני שמשתמשים בכיתה Place, צריך:

יוצרים פרויקט ב-Cloud עם חשבון לחיוב.
מקבלים מפתח API.
מפעילים את ממשקי ה-API הבאים:
- Maps JavaScript API
- Places API
- Places API (חדש) (נדרש לשימוש בחיפוש טקסט (חדש))

מידע נוסף זמין במאמר הגדרת פרויקט ב-Google Cloud.

קבלת מפתח API

הפעלת Places API (חדש)

טעינת ספריית המקומות

כדי לטעון את ספריית המקומות, קודם צריך לטעון את Maps JavaScript API. לשם כך, מוסיפים את מערך האתחול (bootstrap) בשורה לקוד האפליקציה, כפי שמוצג בקטע הקוד הבא:

<script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "weekly",
    // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.).
    // Add other bootstrap parameters as needed, using camel case.
  });
</script>

לאחר מכן, משתמשים באופרטור await כדי לקרוא לפונקציה importLibrary() מתוך פונקציית async, כפי שמוצג כאן:

  const {Place} = await google.maps.importLibrary("places");

התחל בעבודה

קבלת מפתח API והפעלת ממשקי ה-API הנדרשים

טעינת ספריית המקומות

השלבים הבאים