הגדרה והדגמה

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

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

כדי לנסות את כלי השירות האלה, אפשר:

הוספת Maps SDK for iOS Utility Library לפרויקט Xcode

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

שימוש ב-Swift Package Manager

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

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

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

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

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

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

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

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

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

מתקינים את אפליקציית ההדגמה:

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

  1. מורידים את ארכיון דוגמת הקוד מ-GitHub ומחלצים את הארכיון. אפשרות אחרת היא לשכפל את המאגר לספרייה מקומית: 
    git clone https://github.com/googlemaps/google-maps-ios-utils.git
  2. פותחים חלון טרמינל, עוברים לספרייה שבה פרסתם את קובצי הדוגמה, ואז נכנסים לספריית הדוגמאות המתאימה לשפה שבה רוצים להשתמש:

    Swift

    cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeproj

    Objective-C

    cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj

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

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

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 כדי לנסות כל כלי. מידע נוסף מופיע בקטע הוספת כלי לאפליקציה שבהמשך.