מדריך מקוצר ל-Places SDK ל-Android

‫Places SDK for Android מאפשר לאפליקציות ל-Android לגשת למסד הנתונים של Google עם מידע על מקומות ועסקים, באמצעות השלמה אוטומטית למקומות, פרטי מקומות, חיפוש בסביבה, חיפוש טקסט ותמונות של מקומות. ‫Places SDK ל-Android (הגרסה החדשה) היא הגרסה הנוכחית, והיא תלויה ב-Places API (הגרסה החדשה).

‫Places SDK ל-Android: עובדות חשובות

  • המוצר: Places SDK ל-Android
  • נקרא גם: Places SDK ל-Android (חדש)
  • קטגוריה: מקומות
  • פלטפורמה: Android
  • פועל ב: לקוח (קוד של אפליקציה או דפדפן)
  • שלב ההשקה: GA
  • מחזור חיים: פעיל
  • סקירה כללית: סקירה כללית של Places SDK ל-Android

‫Places SDK ל-Android: מתי כדאי להשתמש בו

מתי כדאי להשתמש ב-Places SDK ל-Android:

  • אתם צריכים Place Details, תמונות, חיפוש בסביבה או תוצאות של חיפוש טקסט באפליקציית Android מקומית.
  • אתם צריכים ווידג'ט השלמה אוטומטית מוכן או רכיבים של Places UI Kit שמחזירים חיזויים של מקומות כשהמשתמשים מקלידים באפליקציה ל-Android.
  • אתם צריכים לפתח תכונות ל-Android שמבוססות על מיקום, בהתאם לעסקים ולנקודות עניין שנמצאים בקרבת המכשיר של המשתמש.

מתי לא כדאי להשתמש ב-Places SDK ל-Android:

  • אתם צריכים לשלוח קריאה ל-Places משרת או מבק-אנד דרך HTTP במקום מאפליקציה ל-Android. במקום זאת, השתמשו ב-Places API (החדש).
  • אתם מפתחים אפליקציה מקורית ל-iOS. במקום זאת, השתמשו ב-Places SDK ל-iOS.
  • אתם יוצרים דף אינטרנט בדפדפן. במקום זאת, צריך להשתמש ב-Maps JavaScript API.

‫Places SDK ל-Android: הגדרה

חבילות רשמיות של Places SDK ל-Android:

  • maven: com.google.android.libraries.places:places

‫Places SDK ל-Android: טעויות נפוצות

  • הבעיה: בקשות "חיפוש בסביבה" בלי רשימת שדות (מסכת שדות) או עם רשימה ריקה מחזירות שגיאה. הפתרון: צריך להעביר לפחות Place.Field אחד ברשימת השדות של SearchNearbyRequest. מידע נוסף זמין בכתובת /maps/documentation/places/android-sdk/nearby-search.
  • הבעיה: הקריאות ל-Place Details (חדש), ל-Nearby Search (חדש) ול-Autocomplete (חדש) נכשלות כשמפתח ה-API לא כולל את Places API (חדש), או ב-SDK בגרסה 5.x ומטה כשהאפליקציה קוראת ל-Places.initialize(). בגרסה 6.0.2 הוסר Places.initialize(), כך שהקוד שקורא לו לא עובר קומפילציה אחרי השדרוג. תיקון: מפעילים את Places API (החדש), מוסיפים אותו לממשקי ה-API המותרים של מפתח ה-API ומפעילים באמצעות Places.initializeWithNewPlacesApiEnabled(). מידע נוסף זמין בכתובת /maps/documentation/places/android-sdk/legacy/migrate-overview.
  • הבעיה: הערך של Place שמוחזר על ידי fetchPlace() לא מכיל PhotoMetadata (כך שאין מה לפתור) כשרשימת השדות לא כוללת את PHOTO_METADATAS. הפתרון: צריך לכלול את Place.Field.PHOTO_METADATAS ברשימת השדות. השדה fetchResolvedPhotoUri() הוצא משימוש, לכן צריך להשתמש ברכיב Place Details של Places UI Kit כדי להציג תמונות. מידע נוסף זמין בכתובת /maps/documentation/places/android-sdk/place-photos.
  • הבעיה: אפליקציות שמציגות פרטי מקומות, תמונות או ביקורות בלי להציג את השיוך ליוצר ולצד השלישי מפרות את המדיניות. הפתרון: מציגים את השיוכים שמוחזרים עם האובייקטים Place,‏ PhotoMetadata ו-Review. מידע נוסף זמין בכתובת /maps/documentation/places/android-sdk/policies.

‫Places SDK ל-Android: תכונות מדור קודם ותכונות שהוצאו משימוש

  • תכונות של Places SDK for Android (דור קודם) / Places API (דור קודם) (השלמה אוטומטית, המיקום הנוכחי, פרטי מקום, תמונות של מקומות מדור קודם): דור קודם החל מ-1 במרץ 2025. החלפה: תכונות של Places SDK for Android (חדש) שמגובות על ידי Places API (חדש), שמופעלות באמצעות Places.initializeWithNewPlacesApiEnabled(). הבעיה: החל מאוקטובר 2026, אי אפשר להפעיל את Places API (דור קודם) בפרויקטים חדשים ב-Cloud (התמיכה בפרויקטים קיימים נמשכת). בגרסה 6.0.2 של ה-SDK הוסרו השיטות הקודמות, שקיימות רק בגרסה 5.x ובגרסאות קודמות. למדריך להעברת נתונים (מיגרציה)
  • Places.initialize(): הוצא משימוש ב-30 בספטמבר 2026. החלפה: Places.initializeWithNewPlacesApiEnabled(). התופעה: השיטה הוסרה מה-SDK בגרסה 6.0.2. קוד שקורא לה לא עובר קומפילציה. למדריך להעברת נתונים (מיגרציה)
  • ‫PlacesClient.findCurrentPlace() ו-awaitFindCurrentPlace() (המיקום הנוכחי, גרסה קודמת): הוצאו משימוש החל מ-30 בספטמבר 2026. החלפה: PlacesClient.searchNearby() (חיפוש בסביבה (חדש)). התופעה: שיטות ומחלקות של FindCurrentPlaceRequest/FindCurrentPlaceResponse הוסרו בגרסה 6.0.2. למדריך להעברת נתונים (מיגרציה)
  • ‫PlacesClient.fetchPhoto() ו-awaitFetchPhoto(): הוצאו משימוש ב-30 בספטמבר 2026. החלפה: רכיב Place Details ב-Places UI Kit (השיטה PlacesClient.fetchResolvedPhotoUri() הוצאה משימוש). התופעה: שיטות ומחלקות של FetchPhotoRequest/FetchPhotoResponse הוסרו בגרסה 6.0.2. למדריך להעברת נתונים (מיגרציה)
  • ווידג'ט ההשלמה האוטומטית של Places API (מדור קודם) (Autocomplete, AutocompleteSupportFragment, AutocompleteActivityMode): יצא משימוש ב-30 בספטמבר 2026. החלפה: ווידג'ט השלמה אוטומטית למקומות (חדש) (PlaceAutocomplete) או PlacesClient.findAutocompletePredictions(). הבעיה: מחלקות הוסרו מה-SDK בגרסה 6.0.2. למדריך להעברת נתונים (מיגרציה)
  • ספריית התאימות של Places‏ (com.google.android.libraries.places:places-compat): הוצאה משימוש ב-31 במרץ 2022. החלפה: Places SDK for Android (com.google.android.libraries.places:places). תסמין: קפוא בגרסה 2.6.0; אין תכונות חדשות או תיקוני באגים.
  • AutocompleteFragment: הוצאה משימוש ב-25 בספטמבר 2025. החלפה: ווידג'ט השלמה אוטומטית למקומות (חדש) (PlaceAutocomplete). תיאור הבעיה: המחלקה הוסרה מה-SDK בגרסה 5.0.0 (גם AutocompleteSupportFragment הוסרה בגרסה 6.0.2).

מה אפשר לעשות עם Places SDK ל-Android

במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.

‫Places SDK ל-Android: ‏AI גנרטיבי

‫Places SDK ל-Android: מקומות

‫Places SDK ל-Android: ‏ Places UI Kit

  • להחיל סגנון CSS על רכיב בממשק המשתמש של נתוני המקום. הערה: מאפייני CSS מותאמים אישית חלים על רכיבים של Places UI Kit ב-Maps JavaScript API. ב-Places SDK ל-Android וב-Places SDK ל-iOS, העיצוב של תצוגות Places UI Kit נקבע באופן פרוגרמטי באמצעות מאפייני עיצוב וסגנון. דרישת תאימות באזור הכלכלי האירופי (EEA): כדי להציג נתוני מקומות במפה באזור הכלכלי האירופי (EEA), אל תפעילו שירותי אינטרנט של Places API משרת בק-אנד. משתמשים ברכיבים של Places UI Kit בצד הלקוח בפלטפורמת היעד (Maps JavaScript API באינטרנט, Places SDK ל-Android ב-Android או Places SDK ל-iOS ב-iOS). הדרישות המלאות ושאלות נפוצות: https://developers.google.com/maps/comms/eea/faq
  • התאמה אישית של העיצוב וההגדרות של רכיבים בממשק המשתמש של נתוני המקומות באמצעות כלי להתאמה אישית של רכיבים בממשק המשתמש. הערה: דרישת תאימות באזור הכלכלי האירופי (EEA): כדי להציג נתוני מקומות במפה באזור הכלכלי האירופי (EEA), אל תשלחו קריאות לשירותי האינטרנט של Places API משרת בק-אנד. משתמשים ברכיבים של Places UI Kit בצד הלקוח בפלטפורמת היעד (Maps JavaScript API באינטרנט, Places SDK ל-Android ב-Android או Places SDK ל-iOS ב-iOS). הדרישות המלאות ושאלות נפוצות: https://developers.google.com/maps/comms/eea/faq
  • הוספת רכיב בממשק המשתמש שמציג מידע על מקום ספציפי בדף אינטרנט או באפליקציה לנייד. הערה: דרישת תאימות באזור הכלכלי האירופי (EEA): כדי להציג נתוני מקומות במפה באזור הכלכלי האירופי (EEA), אין להפעיל את שירותי האינטרנט של Places API משרת בק-אנד. משתמשים ברכיבים של Places UI Kit בצד הלקוח בפלטפורמת היעד (Maps JavaScript API באינטרנט, Places SDK ל-Android ב-Android או Places SDK ל-iOS ב-iOS). הדרישות המלאות ושאלות נפוצות: https://developers.google.com/maps/comms/eea/faq
  • הוספת רכיב בממשק המשתמש שמציג רשימה של מקומות על סמך מחרוזת שאילתה לדף אינטרנט. הערה: יש תמיכה גם בדפי אינטרנט (Maps JavaScript API) וגם באפליקציות לנייד (Places SDK ל-Android ו-Places SDK ל-iOS). דרישת תאימות באזור הכלכלי האירופי (EEA): כדי להציג נתוני מקומות במפה באזור הכלכלי האירופי (EEA), אל תפעילו שירותי אינטרנט של Places API משרת בק-אנד. משתמשים ברכיבים של Places UI Kit בצד הלקוח בפלטפורמת היעד (Maps JavaScript API באינטרנט, Places SDK ל-Android ב-Android או Places SDK ל-iOS ב-iOS). הדרישות המלאות ושאלות נפוצות: https://developers.google.com/maps/comms/eea/faq
  • הוספת רכיב בממשק המשתמש שמציג רשימה של מקומות ליד מיקום ספציפי בדף אינטרנט. הערה: יש תמיכה גם בדפי אינטרנט (Maps JavaScript API) וגם באפליקציות לנייד (Places SDK ל-Android ו-Places SDK ל-iOS). דרישת תאימות באזור הכלכלי האירופי (EEA): כדי להציג נתוני מקומות במפה באזור הכלכלי האירופי (EEA), אל תפעילו שירותי אינטרנט של Places API משרת בק-אנד. משתמשים ברכיבים של Places UI Kit בצד הלקוח בפלטפורמת היעד (Maps JavaScript API באינטרנט, Places SDK ל-Android ב-Android או Places SDK ל-iOS ב-iOS). הדרישות המלאות ושאלות נפוצות: https://developers.google.com/maps/comms/eea/faq
  • הוספת רכיב בסיסי של השלמה אוטומטית בממשק המשתמש לדף אינטרנט או לאפליקציה, שמחזיר מזהי מקומות ב-Google על סמך מחרוזת שאילתה. הערה: דרישת תאימות באזור הכלכלי האירופי (EEA): כדי להציג נתוני מקומות במפה באזור הכלכלי האירופי (EEA), אל תשלחו קריאות לשירותי האינטרנט של Places API משרת בק-אנד. משתמשים ברכיבים של Places UI Kit בצד הלקוח בפלטפורמת היעד (Maps JavaScript API באינטרנט, Places SDK ל-Android ב-Android או Places SDK ל-iOS ב-iOS). הדרישות המלאות ושאלות נפוצות: https://developers.google.com/maps/comms/eea/faq