התחל בעבודה

בדף הזה מוסבר איך לקבל מפתח 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");
      

    השלבים הבאים