אפליקציית ההדגמה של ה-SDK ב-GitHub שסופקה עם ה-SDK של מפות Google ל-iOS כוללת דוגמאות של התכונות העיקריות של ה-SDK. בודקים את הקוד באפליקציית ההדגמה כדי לראות איך כל טעימה מוטמעת. אתם יכולים לייבא ולבנות את האפליקציה, להוסיף את מפתח ה-API, לצפות בהדגמה ולהשתמש בקוד לדוגמה שסופק כנקודת התחלה לאפליקציה.
כשמריצים את האפליקציה לדוגמה, מוצגת רשימה של דוגמאות זמינות שאפשר להריץ במכשיר שלכם. בוחרים באחת מהאפשרויות.
הרצה מקומית של האפליקציה לדוגמה
האפליקציה לדוגמה של Maps SDK ל-iOS זמינה כארכיון הורדות מ-GitHub. כדי להתקין את ה-SDK של מפות Google ל-iOS לדוגמה ולנסות אותו, צריך לבצע את השלבים הבאים.
- מורידים את הארכיון לדוגמה של הקוד מ-GitHub ופורקים את הארכיון.
פותחים חלון טרמינל, עוברים לספרייה שבה הרחבתם את הקבצים לדוגמה ובודקים את פירוט הספרייה של 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
- ב-Xcode, לוחצים על לחצן הידור (compile) כדי
ליצור את האפליקציה
עם הסכמה הנוכחית. גרסת ה-build יוצרת שגיאה ומתבקשת להזין את מפתח ה-API בקובץ
SDKConstants.swift
של Swift או בקובץSDKDemoAPIKey.h
של Objective-C. - אם עדיין אין לכם מפתח API, תוכלו לפעול לפי instructions כדי להגדיר פרויקט במסוף Google Cloud ולקבל מפתח API. כשמגדירים את המפתח במסוף Cloud, אפשר להגביל את המפתח למזהה החבילה של האפליקציה לדוגמה, כדי לוודא שרק האפליקציה שלכם תוכל להשתמש בו. מזהה החבילה שמוגדר כברירת מחדל
של אפליקציית דוגמאות ה-SDK הוא
com.example.GoogleMapsDemos
. - עורכים את הקובץ
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";
- מסירים את השורה הבאה, כי היא משמשת לרישום הבעיה שהוגדרה על ידי המשתמש:
Swift
#error (Register for API Key and insert here. Then delete this line.)
Objective-C
#error Register for API Key and insert here.
- יוצרים ומפעילים את הפרויקט. חלון הסימולטור של iOS יופיע עם רשימה של הדגמות של SDK של מפות Google.
- צריך לבחור אחת מהאפשרויות המוצגות כדי להתנסות בתכונה של ה-SDK של מפות Google ל-iOS.
- אם מתבקשים לאפשר ל-GoogleMapsDemos לגשת למיקום, בוחרים באפשרות Allow.