Places SDK ל-iOS מאפשר לאפליקציות ל-iOS לקבל מידע על מקומות (עסקים, נקודות עניין, מיקומים גיאוגרפיים) באמצעות פרטי מקומות, תמונות של מקומות, חיפוש טקסט, חיפוש בסביבה והשלמה אוטומטית. Places API (הגרסה החדשה) היא הגרסה הנוכחית של ה-SDK.
Places SDK ל-iOS: עובדות חשובות
- המוצר: Places SDK ל-iOS
- נקרא גם: Places SDK ל-iOS (חדש)
- קטגוריה: מקומות
- פלטפורמה: iOS
- פועל ב: לקוח (קוד של אפליקציה או דפדפן)
- שלב ההשקה: GA
- מחזור חיים: פעיל
- סקירה כללית: סקירה כללית של Places SDK ל-iOS
Places SDK ל-iOS: מתי כדאי להשתמש בו
מתי כדאי להשתמש ב-Places SDK ל-iOS:
- אתם צריכים תוצאות של פרטי מקומות, תמונות, חיפוש טקסט או חיפוש בסביבה באפליקציה מקורית ל-iOS.
- אתם צריכים השלמה אוטומטית של שם מקום או כתובת בזמן שהמשתמשים מקלידים באפליקציה ל-iOS.
- אתם רוצים רכיבים מוכנים מראש של Places UI Kit (פרטי מקום, חיפוש, השלמה אוטומטית) באפליקציה ל-iOS.
מתי לא כדאי להשתמש ב-Places SDK ל-iOS:
- אתם מפתחים אפליקציה מקורית ל-Android. במקום זאת, השתמשו ב-Places SDK ל-Android.
- אתם יוצרים דף אינטרנט בדפדפן. במקום זאת, צריך להשתמש ב-Maps JavaScript API.
- צריך להעביר נתוני מקומות משרת או מקצה עורפי (backend) באמצעות HTTP, ולא בלקוח iOS. במקום זאת, צריך להשתמש ב-Places API (חדש).
Places SDK ל-iOS: הגדרה
- השירות שצריך להפעיל:
places.googleapis.com - אימות: מפתח API
- שיוך שימוש: קוראים לשיטת המחלקה
addInternalUsageAttributionIDב-GMSPlacesClient(Objective-C/Swift) או ב-PlacesClient(GooglePlacesSwift) כדי להוסיף מזהה שיוך שימוש. מחיקת הקריאה מבטלת את ההסכמה. - תחילת העבודה: הגדרת Places SDK ל-iOS
- Reference: Places SDK for iOS reference
- תמחור: שימוש וחיוב ב-Places SDK ל-iOS
- כללי מדיניות: כללי המדיניות של Places SDK ל-iOS
- נתוני גרסה: נתוני הגרסה של Places SDK ל-iOS
חבילות רשמיות של Places SDK ל-iOS:
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
Places SDK ל-iOS: מוצרים קשורים
- ממשקי API שמשתמשים בהם לעיתים קרובות עם ממשק ה-API הזה: Maps SDK ל-iOS
Places SDK ל-iOS: טעויות נפוצות
- הבעיה: הקריאות ל-Places SDK ל-iOS (החדש) נכשלות אם Places API (החדש) לא מופעל בפרויקט ב-Cloud או לא נמצא ברשימת ממשקי ה-API המורשים של מפתח ה-API. הפתרון: מפעילים את Places API (חדש) ומוסיפים אותו להגבלות על מפתחות ה-API שבהם האפליקציה משתמשת. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/places/ios-sdk/legacy/migrate-overview.
- הבעיה:
kGMSPlacesRateLimitExceeded(-7) פירוש הדבר שמפתח ה-API חרג ממגבלת קצב השימוש שלו. גם אפליקציות בגרסאות SDK 2.x שהושבתו (הושבתו ב-29 ביולי 2019) מקבלות את השגיאה הזו. תיקון: בודקים את המכסה והשימוש ב-Places API (החדש) במסוף Google Cloud, ומעדכנים את האפליקציות בגרסאות SDK שקודמות ל-3.0. אפשר לעיין בכתובת /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode. - הבעיה: שימוש חוזר בטוקנים לסשן באפליקציות שונות באותו פרויקט, או בסשנים שונים, משבש את הקיבוץ של החיובים על סשנים של השלמה אוטומטית. התיקון: יוצרים טוקן לסשן ייחודי (מומלץ להשתמש ב-UUID בגרסה 4) לכל סשן של השלמה אוטומטית. הטוקנים צריכים להיות ייחודיים לכל פרויקט. מידע נוסף זמין בכתובת /maps/documentation/places/ios-sdk/use-session-tokens.
- הבעיה: אפליקציות מציגות נתוני מקומות בלי השיוכים שמוחזרים על ידי ה-API. הפתרון: צריך להציג את כל השיוכים הרלוונטיים שמוחזרים עם נתוני המקומות, בהתאם לדף המדיניות. מידע נוסף זמין בכתובת /maps/documentation/places/ios-sdk/overview.
Places SDK ל-iOS: תכונות מדור קודם ותכונות שהוצאו משימוש
- Places SDK ל-iOS (גרסה קודמת): גרסה קודמת החל מ-1 במרץ 2025. החלפה: Places SDK ל-iOS (חדש) (נדרש Places API (חדש)). התופעה: מחלקות ושיטות מדור קודם (לדוגמה
fetchPlaceFromPlaceID,GMSAutocompleteFetcherו-GMSAutocompleteViewController) לא קיימות ב-SDK בגרסה 11.0.0 ואילך, וזה גורם לכשלים בהידור. למדריך להעברת נתונים (מיגרציה) -
GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCornerו-GMSAutocompleteFetcherinitWithBounds:filter: הוצאו משימוש החל מ-13 באוקטובר 2020. החלפה:GMSAutocompleteFilter(locationBiasאוlocationRestriction) ב-GMSAutocompleteRequestעםGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:, או עם המשניםGooglePlacesSwiftplaceAutocompleteאוbasicPlaceAutocompleteלווידג'ט של ממשק המשתמש. התופעה: השיטות לא קיימות ב-SDK בגרסה 4.0.0 ואילך (והשיטותGMSAutocompleteResultsViewControllerו-GMSAutocompleteFetcherהוסרו ב-SDK בגרסה 11.0.0). למדריך להעברת נתונים (מיגרציה) - גבולות של השלמה אוטומטית שמבוססים על
GMSCoordinateBounds(הפרמטריםGMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode;bounds/boundsModeשלfindAutocompletePredictionsFromQueryו-autocompleteQuery): הוצאו משימוש החל מ-13 באוקטובר 2020. החלפה:GMSAutocompleteRequestב-GMSAutocompleteFilter(locationBiasאוlocationRestriction) ו-GMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:, או המשניםGooglePlacesSwiftplaceAutocompleteאוbasicPlaceAutocompleteלווידג'ט של ממשק המשתמש. התופעה: מאפיינים ופרמטרים לא קיימים ב-SDK בגרסה 4.0.0 ואילך (וגםGMSAutocompleteViewControllerו-findAutocompletePredictionsFromQueryהוסרו ב-SDK בגרסה 11.0.0). למדריך להעברת נתונים (מיגרציה) GMSPlace.openNowStatus: הוצא משימוש ב-13 באוקטובר 2020. החלפה:GMSPlacesClientisOpenWithRequest:callback:(GMSPlaceIsOpenRequest) אוPlacesClient.isPlaceOpen(with:)ב-GooglePlacesSwift. התופעה: המאפיין לא קיים ב-SDK מגרסה 4.0.0 ואילך. למדריך להעברת נתונים (מיגרציה)GMSPlaceFieldבתורNS_ENUM: הוצא משימוש החל מ-13 באוקטובר 2020. החלפה: קבועים שלGMSPlacePropertyעם מחלקות בקשה כמוGMSFetchPlaceRequestו-GMSPlaceSearchByTextRequest, אוPlacePropertyב-GooglePlacesSwift. התופעה: הוחלף ב-NS_OPTIONSב-SDK 4.0.0 (GMSPlaceFieldכיNS_OPTIONSשייך ל-API הקודם ולא קיים ב-SDK 11.0.0 ואילך). למדריך להעברת נתונים (מיגרציה)- גרסה 2.7.0 של Places SDK ל-iOS: הוצאה משימוש ב-29 ביולי 2019. החלפה: הגרסה הנוכחית של Places SDK ל-iOS. התופעה: שגיאות מסוג
kGMSPlacesRateLimitExceeded.
מה אפשר לעשות עם Places SDK ל-iOS
במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.
Places SDK ל-iOS: AI גנרטיבי
- החזרת סיכום מבוסס-AI של ביקורות משתמשים למזהה מקום ספציפי ב-Google.
- החזרת סיכום מבוסס-AI של האזור והשירותים שמסביב למזהה מקום ספציפי ב-Google של תחנת טעינה לרכב חשמלי.
Places SDK ל-iOS: מקומות
- החזרת רשימה של מקומות ו-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.
- הוספת ווידג'ט של השלמה אוטומטית לדף אינטרנט או לאפליקציה שמחזיר תוצאות לגבי מקומות על סמך מחרוזת שאילתה.
- מציינים את שדות הנתונים שייכללו בתגובות עם מידע על מקומות.
- מציינים את סוגי המקומות שרוצים לכלול בתשובות עם מידע על מקומות.
- החזרת מידע על המקום שבו המכשיר של המשתמש נמצא כרגע. הערה: השיטות הקודמות של "המיקום הנוכחי" הוסרו מ-Places SDK ל-Android בגרסה 6.0 ומעלה ומ-Places SDK ל-iOS בגרסה 11.0 ומעלה. צריך לאחזר את הקואורדינטות של המכשיר משירותי המיקום של הפלטפורמה ולהפעיל את "חיפוש בסביבה".
- החזרת סיכום של סקירת AI למקום ספציפי.
- החזרת סיכום מבוסס-AI של אזור שמתאר מקומות באזור סביב מקום ספציפי.
- החזרת מידע על מקומות שנמצאים לאורך מסלול מוגדר מראש, על סמך מחרוזת שאילתה.
- החזרת המרחק, זמן ההגעה וכתובת ה-URI של המסלול למקומות בחיפוש טקסט מקבוצה של קואורדינטות של קו רוחב/קו אורך.
- החזרת המרחק, זמן ההגעה וה-URI של המסלול למקומות בסביבה מקבוצה של קואורדינטות של קו רוחב/אורך.
Places SDK ל-iOS: 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