הגדרה והדגמה

שימוש ב-Swift Package Manager

1. אם עדיין אין לכם פרויקט Xcode, אתם יכולים ליצור אחד עכשיו ולשמור אותו במחשב המקומי. (אם אתם מפתחים מתחילים ב-iOS, יוצרים פרויקט חדש ובוחרים בתבנית של אפליקציית iOS. ב-Xcode 11.7 ואילך, יוצרים אפליקציה עם תצוגה אחת.)
2. מוסיפים את ה-SDK של מפות ל-iOS כיחס תלות. אפשרויות נוספות מפורטות בקטע התקנת ה-SDK.
3. בפרויקט ב-Xcode, עוברים אל File -> Swift Packages -> Add Package Dependency.
4. בחלון שמופיע, מזינים את כתובת ה-URL של המאגר של ספריית התכונות של SDK של מפות ל-iOS https://github.com/googlemaps/google-maps-ios-utils ובוחרים באפשרות הבא.
• בשלב הזה יכול להיות שתתבקשו לבצע אימות באמצעות חשבון GitHub. כדי להמשיך בתהליך, פועלים לפי ההוראות ליצירת אסימון גישה אישי ל-GitHub.
5. בחלון הבא, בוחרים באפשרות Version (גרסה), בוחרים באפשרות Up to Next Major Version (עד לגרסה הראשית הבאה) מהתפריט הנפתח ומזינים את הגרסה העדכנית ביותר של Maps SDK לספריית התכונות של iOS (לדוגמה, 6.0.0).
6. לוחצים על התפריט הנפתח לצד Add to Project (הוספה לפרויקט), בוחרים את הפרויקט ואז בוחרים באפשרות Add Package (הוספת חבילת קוד).

שימוש ב-CocoaPods

1. אם עדיין אין לכם פרויקט Xcode, אתם יכולים ליצור אחד עכשיו ולשמור אותו במחשב המקומי. (אם אתם מפתחים iOS בפעם הראשונה, תוכלו ליצור אפליקציה עם תצוגה אחת).
2. אם עדיין אין לכם קובץ pod בפרויקט, יוצרים קובץ בשם Podfile בספריית הפרויקט. הקובץ הזה מגדיר את יחסי התלות של הפרויקט.
3. עורכים את קובץ ה-pod של הפרויקט ומוסיפים יחסי תלות ל-pod‏ Google-Maps-iOS-Utils. הנה דוגמה שכוללת את יחסי התלות הנדרשים ל-SDK של מפות ל-iOS ולספריית התשתית:

   source 'https://github.com/CocoaPods/Specs.git'
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '9.0.0'
     pod 'Google-Maps-iOS-Utils', '6.1.0' # x-release-please-version
   end

4. מריצים את pod install.
5. סוגרים את Xcode ופותחים (לחיצה כפולה) את הקובץ .xcworkspace של הפרויקט כדי להפעיל את Xcode. מעכשיו והלאה, צריך להשתמש בקובץ .xcworkspace כדי לפתוח את הפרויקט.

הערה: הכלי לאשכולות של סמנים תלוי בעץ ה-Quadtree, אבל אפשר להשתמש בעץ ה-Quadtree בלי אשכולות של סמנים. אם רוצים להשתמש רק בכלי quadtree, אפשר לשנות את הערך של pod 'Google-Maps-iOS-Utils' ל-'Google-Maps-iOS-Utils/QuadTree' בקובץ ה-pod.

שימוש בקובצי GitHub

1. מורידים את הארכיון של דוגמאות הקוד מ-GitHub ומפרקים את הארכיון.
2. פותחים חלון טרמינל, עוברים לספרייה שבה הרחבת את קובצי הדוגמה ומתעדים לספריית הדוגמאות המתאימה לשפה שבה רוצים להשתמש:
   • ב-Swift, מריצים את הפקודה cd google-maps-ios-utils-master/samples/SwiftDemoApp
   • עבור Objective-C, מריצים את הפקודה cd google-maps-ios-utils-master/samples/ObjCDemoApp
3. מריצים את הפקודה הבאה:
   

   pod install

4. סוגרים את Xcode ופותחים (לחיצה כפולה) את הקובץ .xcworkspace של הפרויקט כדי להפעיל את Xcode. מעכשיו והלאה, צריך להשתמש בקובץ .xcworkspace כדי לפתוח את הפרויקט.

Swift

מוסיפים את מפתח ה-API ל-AppDelegate.swift באופן הבא:

1. מוסיפים את הצהרת הייבוא הבאה:

   import GoogleMaps

2. עורכים את השורה הבאה ומוסיפים את מפתח ה-API בין המירכאות הכפולות:

   // Change this key to a valid key registered with the demo app bundle id.
   let mapsAPIKey = ""

Objective-C

מוסיפים את מפתח ה-API ל-AppDelegate.m באופן הבא:

1. מוסיפים את הצהרת הייבוא הבאה:

   @import GoogleMaps;

2. עורכים את השורה הבאה ומוסיפים את מפתח ה-API בין המירכאות הכפולות:

   // Change this key to a valid key registered with the demo app bundle id.
   static NSString *const kMapsAPIKey = @"";