שנתחיל?

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

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

לפני השימוש במחלקה 'מקום', עליך:

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

מידע נוסף על הגדרת הפרויקט ב-Google Cloud

קבלת מפתח API

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

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

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

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

השלבים הבאים

• חיפוש מקומות
• קבלת פרטים על המקום
• שימוש בהשלמה אוטומטית של מקומות