מאגר Maps SDK for iOS ב-GitHub מכיל דוגמאות שממחישות את השימוש ב-Maps SDK for iOS באפליקציה ל-iOS. אפליקציית הדוגמה מכילה קוד להדגשת התכונות של ה-SDK, ואפשר להשתמש בה כנקודת התחלה לאפליקציה שלכם.
רשימת דוגמאות ל-SDK של מפות ל-iOS
בהמשך מפורטות פעילויות לדוגמה מתוך אפליקציית ההדגמה, שמופיעות גם בדפים המקושרים לצורך עיון מהיר. הרשימה המלאה של הדוגמאות הזמינות מופיעה בתיקיית הדוגמאות ב-GitHub.
- הצגת מפה בסיסית
- הצגת חלון מידע לסמן
- הוספת סמן למפה
- המרת קואורדינטות לכתובות של מיקום
- הפעלה והשבתה של מחוות במפה
- טיפול באירועי סמן
- הפעלת כפתור 'המיקום שלי'
- איך מציירים פוליגונים במפה
- ציור קווים שבורים במפה
הרצת אפליקציית הדוגמה המלאה באופן מקומי
אפליקציית הדוגמה של Maps SDK ל-iOS זמינה כארכיון להורדה ב-GitHub. כדי להתקין את אפליקציית הדוגמה של Maps SDK for iOS ולנסות אותה, פועלים לפי השלבים הבאים.
- מריצים את הפקודה git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.gitכדי לשכפל את מאגר הדוגמאות לספרייה מקומית.
- פותחים חלון טרמינל, עוברים לספרייה שבה שיבטתם את קובצי הדוגמה, ומעמיקים לספרייה GoogleMaps: - Swift- cd maps-sdk-for-ios-samples/GoogleMaps-Swift - pod install- open GoogleMapsSwiftXCFrameworkDemos.xcworkspace- Objective-C- cd maps-sdk-for-ios-samples-main/GoogleMaps - pod install- open GoogleMapsDemos.xcworkspace
- ב-Xcode, לוחצים על לחצן ההידור כדי לבנות את האפליקציה עם הסכימה הנוכחית. תהליך הבנייה יפיק שגיאה, שתבקש מכם להזין את מפתח ה-API בקובץ SDKConstants.swiftעבור Swift או בקובץSDKDemoAPIKey.hעבור Objective-C.
- מקבלים מפתח API מהפרויקט שבו מופעל Maps SDK ל-iOS.
- עורכים את הקובץ SDKConstants.swiftב-Swift או את הקובץSDKDemoAPIKey.hב-Objective-C ומדביקים את מפתח ה-API בהגדרה של הקבועapiKeyאוkAPIKey. לדוגמה:Swiftstatic let apiKey = "YOUR_API_KEY" Objective-Cstatic NSString *const kAPIKey = @"YOUR_API_KEY"; 
- בקובץ 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.
- מבצעים Build ומריצים את הפרויקט. מופיע חלון של סימולטור iOS עם רשימה של Maps SDK Demos.
- בוחרים אחת מהאפשרויות שמוצגות כדי להתנסות בתכונה של Maps SDK ל-iOS.
- אם מופיעה בקשה לאפשר ל-GoogleMapsDemos לגשת למיקום שלכם, בוחרים באפשרות אישור.