באפליקציית הדגמה של Places SDK ל-iOS ב-GitHub, שסופקה עם Places SDK ל-iOS, מוצגות כמה תכונות, כולל השלמה אוטומטית של שמות מקומות ותמונות של מקומות. בנוסף, תוכלו למצוא קטעי קוד בכל דף במדריך למפתחים הזה. לייבא ולבנות את האפליקציה, להוסיף את מפתח ה-API, להציג את הדמו ולהשתמש בקוד לדוגמה שסופק כבסיס לאפליקציה.
כשמריצים את אפליקציית הדוגמה, מוצגת רשימה של דוגמאות זמינות שאפשר להריץ במכשיר שלכם. בוחרים באחת מהאפשרויות.
הפעלה מקומית של האפליקציה המלאה לדוגמה
אפליקציית הדוגמה של Places SDK ל-iOS זמינה כארכיון להורדה מ-GitHub. כדי להתקין את אפליקציית הדוגמה של Places SDK ל-iOS ולנסות אותה, פועלים לפי השלבים הבאים.
- מורידים את הארכיון של דוגמאות הקוד מ-GitHub ומפרקים את הארכיון.
פותחים חלון מסוף, עוברים לספרייה שבה הרחבת את קובצי הדוגמה ומתעדים את ספריית GooglePlaces:
Swift
cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift
pod install
open GooglePlacesDemos.xcworkspace
Objective-C
cd maps-sdk-for-ios-samples-master/GooglePlaces
pod install
open GooglePlacesDemos.xcworkspace
- מפעילים את Places SDK ל-iOS בפרויקט במסוף Google Cloud.
- אם עדיין אין לכם מפתח API, עליכם לפעול לפי ההוראות כדי להגדיר פרויקט במסוף Cloud ולקבל מפתח API. כשמגדירים את המפתח במסוף Cloud, אפשר להגביל את המפתח למזהה החבילה של האפליקציה לדוגמה, כדי לוודא שרק האפליקציה שלכם יכולה להשתמש במפתח. מזהה החבילה שמוגדר כברירת מחדל באפליקציית הדוגמאות של ה-SDK הוא
com.example.GooglePlacesDemos
. - עורכים את הקובץ
SDKDemoAPIKey
ומדביקים את מפתח ה-API בתוך הקבוע המתאים. לדוגמה:Swift
let placesAPIKey = "YOUR_API_KEY"
Objective-C
static NSString *const kAPIKey = @"YOUR_API_KEY";
- אם מוצגת ב-Xcode בקשה לבטל את הנעילה של הקובץ
SDKDemoAPIKey
כדי לערוך אותו, בוחרים באפשרות ביטול הנעילה. - אם השורה הזו מופיעה, מסירים אותה כי היא משמשת לרישום הבעיה:
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.
- פיתוח האפליקציה.
- אם ה-build נכשל או שהאפליקציה קורסת עם שגיאה לגבי מפתח ה-API בפעם הראשונה שמפעילים אותה, צריך לוודא שסיפקתם את המפתחות הנדרשים בקובץ
SDKDemoAPIKey
. - אם מריצים את הדוגמאות של GooglePlaces, בחלון של הסימולטור ל-iOS תוצג רשימה של דמו של Places.
- אם מופיעה בקשה לתת ל-GooglePlacesDemos גישה למיקום שלכם, בוחרים באפשרות אישור.
- הדוגמה שבחרתם מוכנה עכשיו להפעלה.