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

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

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

    מחליפים את YOUR_PLACES_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. הדגימה שבחרתם מוכנה עכשיו להפעלה.