דוגמאות קוד של Places SDK ל-iOS

אפליקציית ההדגמה של Places SDK ל-iOS ב-GitHub, שמסופקת עם Places SDK ל-iOS, מדגימה מספר תכונות, כולל השלמה אוטומטית של מקומות ותמונות של מקומות. בנוסף, אפשר למצוא קטעי קוד בכל דף במדריך הזה למפתחים. מייבאים ויוצרים את האפליקציה, מוסיפים את מפתח ה-API, צופים בהדגמה ומשתמשים בקוד לדוגמה שסופק כנקודת התחלה לאפליקציה.

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

הרצת אפליקציית הדוגמה המלאה באופן מקומי

אפליקציית הדוגמה של Places SDK ל-iOS זמינה כארכיון להורדה ב-GitHub. כדי להתקין את אפליקציית הדוגמה של Places SDK ל-iOS ולנסות אותה, פועלים לפי השלבים הבאים.

1. מורידים את ארכיון דוגמאות הקוד מ-GitHub ומחלצים את הארכיון. אפשרות נוספת היא לשכפל את המאגר לספרייה מקומית:

   git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git

2. פותחים חלון טרמינל, עוברים לספרייה שבה פרסתם את קובצי הדוגמה, ומעמיקים לתוך הספרייה GooglePlaces:

   Swift

   cd maps-sdk-for-ios-samples/GooglePlaces-Swift/
   open GooglePlacesSwiftXCFrameworkDemos.xcodeproj

   Objective-C

   cd maps-sdk-for-ios-samples/GooglePlaces
   open GooglePlacesXCFrameworkDemos.xcodeproj

3. בפרויקט Xcode, עוברים אל File (קובץ) > Add Package Dependencies (הוספת תלות בחבילה). מזינים את כתובת ה-URL https://github.com/googlemaps/ios-places-sdk, מקישים על Enter כדי למשוך את החבילה ולוחצים על Add Package (הוספת חבילה).
4. מפעילים את Places SDK ל-iOS בפרויקט במסוף Google Cloud.
5. מקבלים מפתח API מהפרויקט שבו הופעל Places API או Places API (חדש).
6. עורכים את קובץ SDKDemoAPIKey ומדביקים את מפתח ה-API בקבוע המתאים. לדוגמה:

   Swift

   let placesAPIKey = "YOUR_API_KEY"

   Objective-C

   static NSString *const kAPIKey = @"YOUR_API_KEY";

7. אם Xcode מבקש לבטל את הנעילה של הקובץ SDKDemoAPIKey כדי לערוך אותו, בוחרים באפשרות ביטול נעילה.
8. אם השורה הבאה מופיעה, צריך להסיר אותה כי היא משמשת לרישום הבעיה:

   Swift

   #error (Register for API Key and insert here. Then delete this line.)

   Objective-C

   #error Register your API key and insert here, then delete this line.

9. יוצרים את האפליקציה.
10. אם הבנייה נכשלת או שהאפליקציה קורסת עם שגיאה לגבי מפתח ה-API כשמריצים אותה בפעם הראשונה, צריך לוודא שסיפקתם את המפתחות הנדרשים בקובץ SDKDemoAPIKey.
11. אם מריצים את הדוגמאות של GooglePlaces, בחלון של סימולטור iOS תוצג רשימה של Places Demos.
12. אם מופיעה בקשה לאשר ל-GooglePlacesDemos לגשת למיקום שלכם, בוחרים באפשרות אישור.
13. המדגם שבחרתם מוכן עכשיו להפעלה.