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

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

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

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

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

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

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

   Swift

   cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
   pod install
   open GoogleMapsSwiftDemos.xcworkspace

   Objective-C

   cd maps-sdk-for-ios-samples-main/GoogleMaps
   pod install
   open GoogleMapsDemos.xcworkspace

3. ב-Xcode, לוחצים על לחצן הידור (compile) כדי ליצור את האפליקציה עם הסכמה הנוכחית. גרסת ה-build יוצרת שגיאה ומתבקשת להזין את מפתח ה-API בקובץ SDKConstants.swift של Swift או בקובץSDKDemoAPIKey.h של Objective-C.
4. אם עדיין אין לכם מפתח API, תוכלו לפעול לפי instructions כדי להגדיר פרויקט במסוף Google Cloud ולקבל מפתח API. כשמגדירים את המפתח במסוף Cloud, אפשר להגביל את המפתח למזהה החבילה של האפליקציה לדוגמה, כדי לוודא שרק האפליקציה שלכם תוכל להשתמש בו. מזהה החבילה שמוגדר כברירת מחדל של אפליקציית דוגמאות ה-SDK הוא com.example.GoogleMapsDemos.
5. עורכים את הקובץ SDKConstants.swift של SWIFT או את הקובץSDKDemoAPIKey.h של Objective-C ומדביקים את מפתח ה-API בהגדרה של הקבוע apiKey או kAPIKey. למשל:

   Swift

   static let apiKey = "YOUR_API_KEY"

   Objective-C

   static NSString *const kAPIKey = @"YOUR_API_KEY";

6. מסירים את השורה הבאה, כי היא משמשת לרישום הבעיה שהוגדרה על ידי המשתמש:

   Swift

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

   Objective-C

   #error Register for API Key and insert here.

7. יוצרים ומפעילים את הפרויקט. חלון הסימולטור של iOS יופיע עם רשימה של הדגמות של SDK של מפות Google.
8. צריך לבחור אחת מהאפשרויות המוצגות כדי להתנסות בתכונה של ה-SDK של מפות Google ל-iOS.
9. אם מתבקשים לאפשר ל-GoogleMapsDemos לגשת למיקום, בוחרים באפשרות Allow.