קוד לדוגמה של SDK של מפות ל-iOS

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

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

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

רשימת דוגמאות ל-SDK של מפות ל-iOS

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

• הצגת מפה בסיסית
• הצגת חלון מידע של סמן
• הוספת סמן למפה
• המרת קואורדינטות לכתובות (reverse geocoding) של מיקום
• הפעלה והשבתה של תנועות במפה
• טיפול באירועים של סמנים
• הפעלת הכפתור להרשאת מיקום חד פעמית
• שרטוט פוליגונים במפה
• שרטוט קווים פוליגוניים במפה

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

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

חשוב: צריך להסיר את כל יחסי התלות הקיימים שנוספו באמצעות CocoaPods או באופן ידני. הוראות מפורטות זמינות בשלב 2 במאמר "הגדרת פרויקט Xcode".

1. מריצים את הפקודה git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git כדי לשכפל את מאגר הדוגמאות לספרייה מקומית.

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

   Swift

   cd maps-sdk-for-ios-samples/GoogleMaps-Swift
   open GoogleMapsSwiftXCFrameworkDemos.xcodeproj

   Objective-C

   cd maps-sdk-for-ios-samples-main/GoogleMaps
   open GoogleMapsDemos.xcodeproj

3. בפרויקט Xcode, עוברים אל File (קובץ) > Add Package Dependencies (הוספת יחסי תלות בין חבילות). מזינים את כתובת ה-URL‏ https://github.com/googlemaps/ios-maps-sdk, מקישים על Enter כדי למשוך את החבילה ולוחצים על Add Package.
4. ב-Xcode, לוחצים על כפתור הקימפול כדי לבנות את האפליקציה עם הסכימה הנוכחית. ה-build מייצר שגיאה, ומבקש להזין את מפתח ה-API בקובץ SDKConstants.swift ל-Swift או בקובץ SDKDemoAPIKey.h ל-Objective-C.
5. מקבלים מפתח API מהפרויקט שבו מופעל ה-SDK של מפות ל-iOS.
6. עורכים את הקובץ 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";

7. בקובץ SDKConstants.swift (Swift) או בקובץ SDKDemoAPIKey.h (Objective-C), מסירים את השורה הבאה, כי היא משמשת לרישום הבעיה שהוגדרה על ידי המשתמש:

   Swift

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

   Objective-C

   #error Register for API Key and insert here.

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