מתחילים

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

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

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

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

    קבלת מפתח API

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

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

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

    <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");
      

    השלבים הבאים