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

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

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

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

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

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

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

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

   SwiftUI

   cd ios-places-sdk-samples/GooglePlacesDemos/
   open GooglePlacesDemos.xcodeproj

   Swift

   cd ios-places-sdk-samples/GooglePlaces-Swift/
   open GooglePlacesSwiftDemos.xcodeproj

   Objective-C

   cd ios-places-sdk-samples/Archive/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 ואת SDK של מפות ל-iOS בפרויקט ב-מסוף Google Cloud.
5. מקבלים מפתח API מהפרויקט שבו הופעל Places API או Places API (חדש).
6. מוסיפים את מפתח ה-API לאפליקציה באמצעות ההוראות המתאימות שבהמשך.

   SwiftUI

   יוצרים קובץ תצורה מקומי בשם GooglePlacesDemos.xcconfig למפתח ה-API, באותה ספרייה שבה נמצא הקובץ Info.plist של אפליקציית ההדגמה (GooglePlacesDemos/GooglePlacesDemos).

   מוסיפים לקובץ התצורה שתי שורות כדי להגדיר את מפתחות ה-API:

   PLACES_API_KEY = YOUR_PLACES_API_KEY,‏ MAPS_API_KEY = YOUR_MAPS_API_KEY

   מחליפים את YOUR_PLACES_API_KEY ואת YOUR_MAPS_API_KEY במפתחות ה-API מהשלבים הקודמים.

   במאמר פורמט של קובץ הגדרות תצורה (xcconfig) מוסבר איך ליצור קובץ תצורה מקומי.

   Swift

   עורכים את קובץ SDKDemoAPIKey ומדביקים את מפתח ה-API בקבוע המתאים. לדוגמה:

   let placesAPIKey = "YOUR_API_KEY"

   אם השורה הבאה מופיעה, מסירים אותה:

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

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

   Objective-C

   עורכים את קובץ SDKDemoAPIKey ומדביקים את מפתח ה-API בקבוע המתאים. לדוגמה:

   static NSString *const kAPIKey = @"YOUR_API_KEY";

   אם השורה הבאה מופיעה, מסירים אותה

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

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

7. יוצרים את האפליקציה.
8. אם הבנייה נכשלת או שהאפליקציה קורסת עם שגיאה לגבי מפתח ה-API כשמריצים אותה בפעם הראשונה, צריך לוודא שסיפקתם את המפתחות הנדרשים בהוראות שלמעלה.
9. אם מריצים את אפליקציית הדוגמה, בחלון של סימולטור iOS תופיע רשימה של הדגמות של Places.
10. אם מופיעה בקשה לאפשר לאפליקציית ההדגמה לגשת למיקום שלכם, בוחרים באפשרות אישור.
11. המדגם שבחרתם מוכן עכשיו להפעלה.