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.googleapis.com - אימות: מפתח API
- שיוך השימוש: צריך להפעיל את
Places.addInternalUsageAttributionId(String)כשמאתחלים את ה-SDK כדי לשלוח מזהה שיוך שימוש. כדי לבטל את ההסכמה, צריך למחוק את ההפעלה או להעביר מחרוזת ריקה. - תחילת העבודה: הגדרת Places SDK ל-Android
- חומר עזר: חומר עזר בנושא Places SDK ל-Android
- תמחור: שימוש וחיוב ב-Places SDK ל-Android
- כללי מדיניות: כללי המדיניות של Places SDK ל-Android
- נתוני גרסה: נתוני הגרסה של Places SDK ל-Android
חבילות רשמיות של Places SDK ל-Android:
- maven:
com.google.android.libraries.places:places
Places SDK ל-Android: מוצרים קשורים
- בדרך כלל משתמשים בו עם: SDK של מפות ל-Android
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 גנרטיבי
- החזרת סיכום מבוסס-AI של ביקורות משתמשים למזהה מקום ספציפי ב-Google.
- החזרת סיכום מבוסס-AI של האזור והשירותים שמסביב למזהה מקום ספציפי ב-Google של תחנת טעינה לרכב חשמלי.
Places SDK ל-Android: מקומות
- החזרת רשימה של מקומות ו-Place Details על סמך מחרוזת שאילתה.
- החזרת רשימה של מקומות ופרטי מקומות ליד מיקום ספציפי.
- החזרת תוצאות של השלמה אוטומטית לגבי מקומות על סמך מחרוזת שאילתה.
- החזרת מידע מפורט על מקום ספציפי.
- להציג תמונות של מקום ספציפי. הערה: צריך להציג לצד כל תמונה את השיוך ליוצר (שם היוצר, עם קישור ל-URI של הפרופיל שלו). הדרישה הזו מופיעה במדיניות של כל פלטפורמה בנושא מקומות, למשל: /maps/documentation/javascript/policies#photo-attributions וגם /maps/documentation/places/web-service/policies#photos-and-review.
- שינוי הגודל של תמונות המקומות.
- הצגת דירוגים וביקורות של מקום ספציפי. הערה: בשירות האינטרנט של Places API (חדש), פרטי המקום הם בקשת GET אל https://places.googleapis.com/v1/places/{placeId} עם X-Goog-FieldMask (לדוגמה, rating,userRatingCount,reviews). חיפוש טקסט, חיפוש בסביבה והשלמה אוטומטית משתמשים ב-POST. ב-Android, מעבירים את Place.Field.RATING, USER_RATING_COUNT ו-REVIEWS אל PlacesClient.fetchPlace(). ב-iOS, מעבירים את GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal ו-GMSPlacePropertyReviews ב-GMSFetchPlaceRequest.
- הוספת ווידג'ט של השלמה אוטומטית לדף אינטרנט או לאפליקציה שמחזיר תוצאות לגבי מקומות על סמך מחרוזת שאילתה.
- מציינים את שדות הנתונים שייכללו בתגובות עם מידע על מקומות.
- מציינים את סוגי המקומות שרוצים לכלול בתשובות עם מידע על מקומות.
- החזרת ה-URI כדי לפתוח את דף הפרטים של מקום מסוים במפות Google.
- החזרת מידע על המקום שבו המכשיר של המשתמש נמצא כרגע. הערה: השיטות הקודמות של "המיקום הנוכחי" הוסרו מ-Places SDK ל-Android בגרסה 6.0 ומעלה ומ-Places SDK ל-iOS בגרסה 11.0 ומעלה. צריך לאחזר את הקואורדינטות של המכשיר משירותי המיקום של הפלטפורמה ולהפעיל את "חיפוש בסביבה".
- החזרת סיכום של סקירת AI למקום ספציפי.
- החזרת סיכום מבוסס-AI של אזור שמתאר מקומות באזור סביב מקום ספציפי.
- החזרת מידע על מקומות שנמצאים לאורך מסלול מוגדר מראש, על סמך מחרוזת שאילתה.
- החזרת המרחק, זמן ההגעה וכתובת ה-URI של המסלול למקומות בחיפוש טקסט מקבוצה של קואורדינטות של קו רוחב/קו אורך.
- החזרת המרחק, זמן ההגעה וה-URI של המסלול למקומות בסביבה מקבוצה של קואורדינטות של קו רוחב/אורך.
- החזרת המרחק, זמן ההגעה וכתובת ה-URI של המסלול בין נקודת המוצא של מסלול מוגדר מראש לבין כל אחד מהמקומות שמוחזרים על סמך מחרוזת שאילתה, שנמצאים גם הם לאורך המסלול.
- החזרת המרחק, זמן ההגעה וה-URI של המסלול בין כל אחד מהמקומות שמוחזרים על סמך מחרוזת שאילתה, שנמצאים גם לאורך מסלול מוגדר מראש, לבין יעד המסלול.
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