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

בחירת פלטפורמה: Android iOS JavaScript

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

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

הפעלה מקומית של האפליקציה המלאה לדוגמה

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

  1. מורידים את הארכיון של דוגמאות הקוד מ-GitHub ומפרקים את הארכיון.
  2. פותחים חלון מסוף, עוברים לספרייה שבה הרחבת את קובצי הדוגמה ומתעדים את ספריית 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
  3. מפעילים את Places SDK ל-iOS בפרויקט במסוף Google Cloud.
  4. אם עדיין אין לכם מפתח API, עליכם לפעול לפי ההוראות כדי להגדיר פרויקט במסוף Cloud ולקבל מפתח API. כשמגדירים את המפתח במסוף Cloud, אפשר להגביל את המפתח למזהה החבילה של האפליקציה לדוגמה, כדי לוודא שרק האפליקציה שלכם יכולה להשתמש במפתח. מזהה החבילה שמוגדר כברירת מחדל באפליקציית הדוגמאות של ה-SDK הוא com.example.GooglePlacesDemos.
  5. עורכים את הקובץ SDKDemoAPIKey ומדביקים את מפתח ה-API בתוך הקבוע המתאים. לדוגמה:

    Swift

    let placesAPIKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. אם מוצגת ב-Xcode בקשה לבטל את הנעילה של הקובץ SDKDemoAPIKey כדי לערוך אותו, בוחרים באפשרות ביטול הנעילה.
  7. אם השורה הזו מופיעה, מסירים אותה כי היא משמשת לרישום הבעיה:

    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.
  8. פיתוח האפליקציה.
  9. אם ה-build נכשל או שהאפליקציה קורסת עם שגיאה לגבי מפתח ה-API בפעם הראשונה שמפעילים אותה, צריך לוודא שסיפקתם את המפתחות הנדרשים בקובץ SDKDemoAPIKey.
  10. אם מריצים את הדוגמאות של GooglePlaces, בחלון של הסימולטור ל-iOS תוצג רשימה של דמו של Places.
  11. אם מופיעה בקשה לתת ל-GooglePlacesDemos גישה למיקום שלכם, בוחרים באפשרות אישור.
  12. הדוגמה שבחרתם מוכנה עכשיו להפעלה.