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

‫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 SDK ל-iOS:

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
  • ממשקי 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 ואילך, וזה גורם לכשלים בהידור. למדריך להעברת נתונים (מיגרציה)
  • ‫GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner ו-GMSAutocompleteFetcher initWithBounds:filter: הוצאו משימוש החל מ-13 באוקטובר 2020. החלפה: GMSAutocompleteFilter (locationBias או locationRestriction) ב-GMSAutocompleteRequest עם GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:, או עם המשנים GooglePlacesSwift placeAutocomplete או 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) ו-GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:, או המשנים GooglePlacesSwift placeAutocomplete או basicPlaceAutocomplete לווידג'ט של ממשק המשתמש. התופעה: מאפיינים ופרמטרים לא קיימים ב-SDK בגרסה 4.0.0 ואילך (וגם GMSAutocompleteViewController ו-findAutocompletePredictionsFromQuery הוסרו ב-SDK בגרסה 11.0.0). למדריך להעברת נתונים (מיגרציה)
  • GMSPlace.openNowStatus: הוצא משימוש ב-13 באוקטובר 2020. החלפה: GMSPlacesClient isOpenWithRequest: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 גנרטיבי

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

‫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