סקירה כללית של דוגמאות קוד

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

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

התנסות בהדגמות ה-SDK

אפליקציית ההדגמה של ה-SDK של מפות Google ל-iOS זמינה כארכיון הורדות מ-GitHub וגם כ-CocoaPods. CocoaPods הוא מנהל יחסי תלות של קוד פתוח לפרויקטים של Swift ו-Objective-C Cocoa.

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

1. כדי לקבל את הקבצים לדוגמה, אפשר להשתמש באחת משתי השיטות הבאות:
   

   ישירות מ-GitHub

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

      Swift

      cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift

      Objective-C

      cd maps-sdk-for-ios-samples-main/GoogleMaps

   3. מריצים את הפקודות הבאות:
      

      Swift

      pod install
      open GoogleMapsSwiftDemos.xcworkspace

      Objective-C

      pod install
      open GoogleMapsDemos.xcworkspace

   שימוש ב-CocoaPods v1.6.1

   1. אם הכלי CocoaPods לא מותקן במחשב שלכם, מריצים את הפקודה הבאה מהמסוף כדי להתקין את גרסה 1.6.1 ב-macOS. לפרטים נוספים אפשר לעיין במדריך לתחילת העבודה של CocoaPods.
      יש בעיה ידועה עם 'pod try' ב-CocoaPods בגרסה 1.8.1 ואילך. כדי לאחזר את הקבצים באמצעות Cocoapods, מומלץ להשתמש בגרסה 1.6.1 של CocoaPods. לחלופין, אפשר להוריד את הקבצים לדוגמה מ-GitHub.

      sudo gem install cocoapods -v1.6.1

   2. אחזור הקבצים של מפות Google באמצעות Cocoapods:

      pod try GoogleMaps

      כשתתבקשו, בוחרים ב-Swift או ב-Objective-C. מערכת CocoaPods מעדכנת את מאגרי המפרט שלך, ולאחר מכן פותחת את ההדגמה בפרויקט Xcode זמני בשם SwiftDemoApp.xcodeproj או ObjCDemoApp.xcodeproj.

2. ב-Xcode, צריך ללחוץ על לחצן ההידור כדי לפתח את הסכמה הנוכחית ולהפעיל אותה. גרסת ה-build יוצרת שגיאה ומופיעה בקשה להזין את מפתח ה-API בקובץ SDKConstants.swift של Swift אוSDKDemoAPIKey.h בקובץ של Objective-C.
3. אם עדיין אין לכם מפתח API, בצעו את instructions כדי להגדיר פרויקט במסוף Google Cloud ולקבל מפתח API. כשמגדירים את המפתח במסוף Cloud, אפשר לציין את מזהה החבילה של האפליקציה כדי להבטיח שרק האפליקציה תוכל להשתמש במפתח. מזהה החבילה שמוגדר כברירת מחדל באפליקציה לדוגמה של ה-SDK הוא com.example.GoogleMapsDemos.
4. עורכים את הקובץ 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";

5. יש להסיר את השורה הבאה, משום שהיא משמשת לרישום הבעיה בהגדרת המשתמש:

   Swift

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

   Objective-C

   #error Register for API Key and insert here.

6. בונים ומפעילים את הפרויקט. ייפתח חלון הסימולטור של iOS עם רשימה של הדגמות SDK של מפות Google.
7. בחר באחת מהאפשרויות המוצגות כדי להתנסות בתכונה של ה-SDK של מפות Google ל-iOS.
8. אם מוצגת בקשה לתת ל-Google MapsDemos גישה למיקום, צריך לבחור באפשרות אישור.

איך משתמשים בקטעי הקוד מהמדריך למפתחים

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