הגדרה והדגמה

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

בדף הזה נסביר איך להגדיר ספריית תשתיות ל-SDK של מפות Google ל-iOS.

כדי לנסות את הכלים האלה, תוכלו:

• התקנה של ספריית כלי השירות בפרויקט Xcode קיים. הוסיפו את הכלים האלה לפרויקט שלכם.
• מתקינים ומפעילים את אפליקציית ההדגמה. אפליקציית ההדגמה היא פרויקט עצמאי שמכיל את כל הקוד שנדרש כדי לנסות את הכלים האלה.

הוספה של ה-SDK של מפות Google ל-iOS Utility Library לפרויקט Xcode

כדי להוסיף את ספריית כלי השירות לסביבת העבודה של Xcode, פועלים לפי השלבים הבאים:

שימוש במנהל החבילות SWIFT

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

שימוש ב-CocoaPods

1. אם עדיין אין לך פרויקט Xcode, עליך ליצור פרויקט עכשיו ולשמור אותו ב- במחשב המקומי שלכם. (אם אין לכם ניסיון בפיתוח iOS, צרו קובץ הצגת הבקשה).
2. אם עדיין אין לכם קובץ Pod לפרויקט, צריך ליצור קובץ. בשם Podfile בספריית הפרויקט שלך. הקובץ הזה מגדיר את של יחסי התלות של הפרויקט.
3. עורכים את קובץ ה-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.0.0' # x-release-please-version
   end

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

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

הוספה של מפתח ה-API לאפליקציה

במאמר הגדרת פרויקט Xcode אפשר למצוא הוראות ליצירת מפתח API ולהוסיף אותו לפרויקט Xcode.

בנייה והפעלה של הפרויקט

אחרי שמוסיפים את מפתח ה-API, יוצרים ומפעילים את הפרויקט.

שימוש בכלי עזר באפליקציה

במסמכי התיעוד של כל כלי שירות יש מידע נוסף על השימוש בו באפליקציה:

• סמן קיבוץ לאשכולות
• Quadtree
• רינדור KML
• רינדור GeoJSON
• מפת חום

התקנה והפעלה של אפליקציית ההדגמה

ספריית כלי השירות כוללת אפליקציית הדגמה שאפשר להתקין ואז לנסות כל כלי שירות.

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

מתקינים את אפליקציית ההדגמה באחת משתי השיטות הבאות:

שימוש בקבצים מ-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 כדי לפתוח את הפרויקט.

להשתמש ב-CocoaPods גרסה 1.6.1

1. פותחים חלון טרמינל ומתקינים את גרסה 1.6.1:

   sudo gem install cocoapods -v1.6.1

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

   pod try Google-Maps-iOS-Utils

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

הוספה של מפתח ה-API לאפליקציית ההדגמה

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

הערה: אם במפתח ה-API שלכם מוגדרת הגבלת אפליקציה, חשוב להוסיף למפתח את מזהה החבילה של האפליקציה. לדוגמה, אם אתם מריצים אפליקציית ההדגמה. מזהה החבילה הוא com.google.gmsutils.DemoApp. אפשר לקרוא מידע נוסף במאמר קבלת מפתח API. הגבלת מפתח.

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 = @"";

יצירה והפעלה של אפליקציית ההדגמה

אחרי שמוסיפים את מפתח ה-API, יוצרים ומפעילים את הפרויקט:

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