מאגר 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 installopen GoogleMapsSwiftXCFrameworkDemos.xcworkspaceObjective-C
cd maps-sdk-for-ios-samples-main/GoogleMaps
pod installopen 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. לדוגמה:Swift
static let apiKey = "YOUR_API_KEY"
Objective-C
static 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 לגשת למיקום שלכם, בוחרים באפשרות אישור.