> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# אינטגרציית Google Places

> חברו את האפליקציה שלכם ל-Google Places כדי לחפש, להציע ולהציג בקלות מקומות מהעולם האמיתי.

<Info>
  <u>הערה</u>: אינטגרציית Google Places זמינה בתוכנית Builder ומעלה. אם אתם בתוכנית החינמית, תצטרכו לשדרג את האפליקציה כדי להשתמש בפונקציות צד-שרת ובתכונות תשלום.
</Info>

***

# הגדרה שלב אחר שלב:

## חלק 1: צד Google

אם יש לכם כבר מפתח API של Google Places, תוכלו לדלג ל[****חלק 2: צד Base44.****](https://docs.base44.com/Integrations/Google-places-integration#part-2%3A-the-base44-side)

<Steps>
  <Step title="צרו (או בחרו) פרויקט ב-Google Cloud">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/GoogleCloudConsole.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=d5b443da6da1f62941411efeee7f7d64" alt="Google Cloud Console Pn" width="1550" height="827" data-path="images/GoogleCloudConsole.png" />

    * עברו ל-Google Cloud Console ובחרו פרויקט קיים או צרו אחד חדש.
  </Step>

  <Step title="הפעילו את places API (New)">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/GoogleAPI.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=a03ab9df6cb3aaa4c29231d45d882b44" alt="Google API Pn" width="1900" height="855" data-path="images/GoogleAPI.png" />

    * בסרגל הצד השמאלי, לחצו על **APIs and Services** → **Library**.
    * השתמשו בסרגל החיפוש כדי למצוא **Places API (New)** ופתחו אותו.
    * לחצו על **Enable** כדי להפעיל אותו עבור הפרויקט שלכם.
  </Step>

  <Step title="צרו את מפתח ה-API שלכם">
    * מדף ה-credentials של ה-API, לחצו על **Create Key** והעתיקו אותו.
    * שמרו את המפתח במקום בטוח. תצטרכו להדביק אותו ב-Base44.
  </Step>
</Steps>

<Tip>
  אם תראו שגיאה כמו `REQUEST_DENIED` בהמשך, בדרך כלל זה אומר שחיוב לא מופעל או שמגבלות מפתח ה-API שלכם הדוקות מדי. הפעלת חיוב והקלת מגבלות במהלך בדיקה לעיתים פותרת זאת. אם אתם מתכננים להציג מפה בדפדפן, עליכם להפעיל גם את **Maps JavaScript API** ולהשתמש במפתח דפדפן שמוגבל לאתר שלכם.
</Tip>

***

## חלק 2: צד Base44

לאחר שיש לכם את מפתח ה-API של Google Places, ניתן לחבר אותו ל-Base44 בשתי דרכים שונות:

<CardGroup cols={2}>
  <Card icon="sparkle" href="https://docs.base44.com/Integrations/Google-places-integration#option-a%3A-ready-made-integration-create-a-new-app" title="אפשרות A: אינטגרציה מוכנה (מועדף)">
    * בחרו במסלול זה אם אתם מתחילים אפליקציה חדשה מאפס.
  </Card>

  <Card icon="bolt" href="https://docs.base44.com/Integrations/Google-places-integration#option-b%3A-instant-integration-connecting-to-an-existing-app" title="אפשרות B: אינטגרציה מיידית">
    * בחרו במסלול זה אם אתם כבר באמצע בנייה ורוצים לשלב את Google Places באפליקציה קיימת.
  </Card>
</CardGroup>

### אפשרות A: אינטגרציה מוכנה (יצירת אפליקציה חדשה)

<Steps>
  <Step title="בחרו את האינטגרציה">
    * ב-Base44 לחצו על Integrations

          <img src="https://mintcdn.com/base44/oUaRpzSyJvMVshj9/images/Integrations.png?fit=max&auto=format&n=oUaRpzSyJvMVshj9&q=85&s=16ac71b185167177ef260be7c92b0339" alt="Integrations Pn" width="1570" height="652" data-path="images/Integrations.png" />

    * מצאו את **Google Places**

    * בחרו **Use this Integration**
  </Step>

  <Step title="ספקו את מפתח ה-API שלכם">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/GoogleIntegration.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=896eb0dc8f08cd285bcf6c001068d45d" alt="Google Integration Pn" width="1863" height="809" data-path="images/GoogleIntegration.png" />

    * כשתתבקשו, הדביקו את מפתח Places API שלכם בשדה שמסומן `GOOGLE_PLACES_API_KEY`.
  </Step>

  <Step title="בנו את האפליקציה שלכם">
    * בצ'אט הבינה המלאכותית, תארו את מטרת האפליקציה.
    * לדוגמה:\
      ` צור אפליקציה לתכנון הטיול הבא שלי. אני אגיד לך את העיר, אתה תציע חמישה מקומות ותציג אותם על מפת Google Places.`
    * הבינה המלאכותית של Base44 תבנה לכם את המבנה הבסיסי.
  </Step>

  <Step title="בדקו עם טיול לדוגמה">
    * הזינו עיר, חפשו עד חמישה מקומות, ושמרו את הטיול.
    * בדקו שמופיעה מפה עם סימונים עבור כל המקומות שנבחרו ושהיא מתקרבת אוטומטית כדי להתאים להם.
  </Step>
</Steps>

***

### אפשרות B: אינטגרציה מיידית (חיבור לאפליקציה קיימת)

השתמשו בגישה זו כשהאפליקציה שלכם בנויה חלקית ואתם רוצים לשלב את Places מבלי להתחיל מחדש.

<Steps>
  <Step title="גשו לאפליקציה הקיימת שלכם">
    * הנה ההודעה שהקלדנו בצ'אט הבינה המלאכותית כדי לבנות את האפליקציה לדוגמה: \
      ` "צור אפליקציה לתכנון הטיול הבא שלי. אני אגיד לך את העיר ואתה תבחר חמישה מקומות לבקר בהם."`
  </Step>

  <Step stepNumber={2} title="חברו את האפליקציה שלכם ל-Google Places באמצעות צ'אט הבינה המלאכותית">
    <img src="https://mintcdn.com/base44/x7uieDiv9xNLARBF/images/TripPlannerApp.png?fit=max&auto=format&n=x7uieDiv9xNLARBF&q=85&s=3eddfdc78ee42b5a7af9fba1e6755bf4" alt="Trip Planner App Pn" width="1889" height="853" data-path="images/TripPlannerApp.png" />

    * בקשו מהצ'אט לחבר את האפליקציה שלכם ל-Google Places. ניתן לערוך את ההודעה לדוגמה הזו:

      `חבר את האפליקציה הזו ל-Google Places באמצעות Places API (New). בקש ממני את GOOGLE_PLACES_API_KEY ושמור אותו כ-Secret. צור פונקציות צד-שרת ל:`

      `- חיפוש לפי טקסט והחזרת id, displayName, formattedAddress, location, types`

      `- קבלת פרטים לפי place_id עם אותם שדות`

      `כל הקריאות חייבות לרוץ מצד-שרת בלבד.`
  </Step>

  <Step stepNumber={3} title="כשצ'אט הבינה המלאכותית יבקש, הדביקו את מפתח ה-API שלכם">
    <img src="https://mintcdn.com/base44/-Vklow6W-uVvNnvR/images/setsecrets.png?fit=max&auto=format&n=-Vklow6W-uVvNnvR&q=85&s=6f96c4ed12b712cbb8ccee93cb0f761d" alt="Setsecrets Pn" width="802" height="522" data-path="images/setsecrets.png" />

    * כשצ'אט הבינה המלאכותית יבקש, לחצו על `Update GOOGLE_PLACES_API_KEY`
    * לאחר מכן הדביקו את מפתח ה-API שלכם בחלון הקופץ
  </Step>

  <Step stepNumber={4} title="בנו את הממשק">
    * הוסיפו את ממשק Trip Planner ואת המפה.
    * תוכלו להשתמש בהודעה דומה לזו כדי לבנות את הממשק שלכם:

      `הוסף דף Trip Planner עם:`

      `- שדה עיר`

      `- 5 שדות הצעת מקומות אוטומטיים המופעלים על ידי הצד-שרת`

      `כאשר נבחר מקום, שמור place_id, name, formatted_address, latitude, longitude, types.`

      `הוסף Google Map שמציב סמן עבור כל מקום שנשמר ומתאים אוטומטית את הגבולות כדי להציג את כולם. כלול כפתור Reset.`
  </Step>

  <Step stepNumber={5} title="בדקו את האפליקציה שלכם">
    * הזינו עיר ותנו לאפליקציה להציע חמישה מקומות, ואז שמרו.
    * ודאו שהסמנים מופיעים ושהמפה מתאימה לכל הנקודות.
    * רעננו את האפליקציה כדי לאשר שהמקומות השמורים מוצגים נכון.
  </Step>
</Steps>

***

## **פתרון בעיות**

* **שגיאות 403 או REQUEST\_DENIED** – בדרך כלל Places API לא מופעל, מפתח ה-API שגוי, או שמגבלות המפתח הדוקות מדי. בדקו שוב ש-**Places API (New)** מופעל, שחשבון החיוב שלכם מוגדר, והקלו על המגבלות במהלך בדיקה.
* **הצעות ריקות** – נסו עיר אחרת או מונח חיפוש אחר. ודאו שהחיפוש מתרחש בצד-שרת, לא בדפדפן.
* **המפה לא מתאימה לכל הנקודות** – ודאו שהאפליקציה שלכם קוראת ל-fitBounds לאחר שכל הסמנים נוספו למפה.
* **שדות שגויים נשמרו** – שמרו בדיוק את השדות הרשומים למעלה (place\_id, name, formatted\_address, latitude, longitude, types) כדי שהמפה והמסננים יעבדו בצורה אמינה.

## שימושים נפוצים

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

* **מתכנני טיולים** – הציעו מסעדות, אטרקציות או מלונות כשמישהו בוחר עיר.
* **מאתרי עסקים מקומיים** – אפשרו למשתמשים לחפש בתי קפה, חנויות או שירותים בקרבת מקום.
* **עוזרי מסלול** – הציגו תחנות דלק, תחנות מנוחה או נקודות אוכל לאורך מסע.
* **כלי נדל"ן** – הדגישו בתי ספר, פארקים או חנויות ליד נכס.
* **מאתרי שירותי חירום** – מצאו במהירות בתי חולים, תחנות משטרה או בתי מרקחת.
* **מדריכי ערים** – בנו אפליקציות עם נקודות ציון, אירועים או נקודות סגנון חיים אוצרים.

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

<Note>דף זה תורגם באמצעות בינה מלאכותית. למידע המדויק והעדכני ביותר, עיין ב[גרסה האנגלית](/). </Note>