מאגר 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-main/GoogleMaps-Swift
pod install
open GoogleMapsSwiftDemos.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
. לדוגמה: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.
- בוחרים באחת מהאפשרויות שמוצגות כדי להתנסות בתכונה של Maps SDK ל-iOS.
- אם מופיעה בקשה לאפשר ל-GoogleMapsDemos לגשת למיקום שלכם, בוחרים באפשרות אישור.