הגדרה

בדף הזה מוסבר מה צריך לעשות כדי להתחיל לפתח באמצעות Maps 3D SDK ל-iOS. תהליך ההגדרה כולל הגדרה של פרויקט בענן ב-Google Cloud ו-API לשימוש עם ה-SDK, ואז הגדרה של פרויקט Xcode. צריך לבצע את השלבים הבאים לפני הוספת המפה התלת-ממדית הראשונה לאפליקציה.

דרישות מוקדמות

כדי להשתמש ב-Maps 3D SDK ל-iOS, הפרויקט ומכשירי היעד צריכים לעמוד בדרישות הבאות:

  • גרסת iOS מינימלית: גרסת iOS‏ 16.0 או גרסה חדשה יותר.
  • ‫Xcode: Xcode בגרסה 16.0 ואילך.

הגדרת פרויקט בענן ב-Google Cloud ומפתח API

כדי להתחיל לפתח באמצעות Maps 3D SDK ל-iOS, צריך להגדיר פרויקט בענן ב-Google Cloud ומפתח API לשימוש עם Maps 3D SDK ל-iOS. לשם כך, מבצעים את השלבים הבאים:

שלב 1

המסוף

  1. במסוף Google Cloud, בדף לבחירת הפרויקט לוחצים על Create Project כדי ליצור פרויקט חדש ב-Cloud.

    כניסה לדף לבחירת הפרויקט

  2. הקפידו לוודא שהחיוב מופעל בפרויקט שלכם ב-Cloud. מוודאים שהחיוב מופעל בפרויקט.

    ב-Google Cloud יש תקופת ניסיון בחינם. תקופת הניסיון מסתיימת אחרי 90 יום או אחרי שהחשבון צבר חיובים בסך 300$, המוקדם מביניהם. אפשר לבטל בכל שלב. מידע נוסף זמין במאמרים זיכויים בחשבון לחיוב וחיוב.

Cloud SDK

gcloud projects create "PROJECT"

מידע נוסף על Google Cloud SDK , התקנת Cloud SDK , והפקודות הבאות:

שלב 2

כדי להשתמש ב-Google Maps Platform, צריך להפעיל את ממשקי ה-API או ערכות ה-SDK שבהם רוצים להשתמש בפרויקט.

שימו לב: בחלק מהשילובים צריך להפעיל כמה ממשקי API או ערכות SDK. אם אתם לא בטוחים אילו ממשקי API או ערכות SDK להפעיל, נסו להשתמש ב-Capabilities Explorer או לעיין במסמכי התיעוד של ממשק ה-API או ערכת ה-SDK שבהם אתם רוצים להשתמש.

כדי להפעיל ממשקי API או ערכות SDK:

המסוף

  1. כדי לראות את ממשקי ה-API וערכות ה-SDK של Google Maps Platform שאפשר להפעיל, נכנסים לדף Maps API Library במסוף Cloud:

    נכנסים לדף Maps API Library.

  2. לוחצים על ה-API או ה-SDK שרוצים להפעיל.
    • אם בכפתור כתוב ENABLE, לוחצים עליו כדי להפעיל את ה-API או ה-SDK.
    • אם בלחצן כתוב MANAGE, ה-API או ה-SDK כבר מופעלים ואין צורך לעשות שום דבר נוסף.
    • לחיצה על אחד מהלחצנים תציג את מרכז הבקרה של ה-API או ה-SDK. (לוחצים על הכפתור DISABLE כדי להסיר את ה-API או ה-SDK מהפרויקט).

Cloud SDK

הפקודה הבאה מפעילה את כל ממשקי ה-API של מפות Google, מסלולים ומקומות:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

מידע נוסף על Google Cloud SDK , התקנת Cloud SDK , והפקודות הבאות:

כדי להפעיל את ממשקי ה-API של הסביבה, משתמשים בפקודה הבאה:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

שלב 3

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

מפתח ה-API הוא מזהה ייחודי שמאמת בקשות שמשויכות לפרויקט שלכם לצורכי שימוש וחיוב. צריך להיות לפחות מפתח API אחד שמשויך לפרויקט.

כך יוצרים מפתח API:

המסוף

  1. נכנסים לדף Google Maps Platform > Credentials.

    כניסה לדף Credentials

  2. בדף Credentials, לוחצים על Create credentials > מפתח API.
    בתיבת הדו-שיח API key created מוצג מפתח ה-API החדש שיצרתם.
  3. לוחצים על סגירה.
    מפתח ה-API החדש מופיע בדף Credentials בקטע API keys.
    (חשוב לזכור להגביל את מפתח ה-API לפני שמשתמשים בו בסביבת הייצור).

Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

מידע נוסף על Google Cloud SDK , התקנת Cloud SDK , והפקודות הבאות:

כדי להפעיל את ה-SDK, נכנסים לדף Maps 3D SDK ל-iOS במסוף Google Cloud. מידע נוסף על השלבים האלה מופיע במאמר תחילת השימוש ב-Google Maps Platform.

הגדרת פרויקט Xcode

בקטע הזה מוסבר איך ליצור ולהגדיר פרויקט Xcode לשימוש עם Maps 3D SDK ל-iOS.

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

שלב 1: מתקינים את התוכנה הנדרשת

כדי ליצור פרויקט באמצעות Maps 3D SDK ל-iOS, צריך להוריד ולהתקין את:

  • ‫Xcode מגרסה 16.0 ואילך

שלב 2: יוצרים את הפרויקט ב-Xcode ומתקינים את Maps 3D SDK ל-iOS

Swift Package Manager

אפשר להתקין את Maps 3D SDK ל-iOS באמצעות Swift Package Manager.

כדי להוסיף את ה-SDK לפרויקט חדש או קיים, פועלים לפי השלבים הבאים:

  • פותחים את project או את workspace ב-Xcode, ואז עוברים אל File (קובץ) > Add Package Dependencies (הוספת יחסי תלות בין חבילות).
  • מזינים את כתובת ה-URL‏ https://github.com/googlemaps/ios-maps-3d-sdk, מקישים על Enter כדי למשוך את החבילה ולוחצים על Add Package.
  • בחלון בחירת מוצרים לחבילה, מוודאים שהמוצר GoogleMaps3D יתווסף ליעד הראשי שהוגדר. בסיום, לוחצים על הוספת חבילה.
  • כדי לאמת את ההתקנה, עוברים לחלונית General של היעד. בקטע Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע) אמורות להופיע החבילות שהותקנו. אפשר גם לעיין בקטע Package Dependencies (יחסי תלות של חבילות) ב-Project Navigator (ניווט בפרויקט) כדי לאמת את החבילה ואת הגרסה שלה.

שלב 3: מוסיפים את מפתח ה-API לאפליקציה

Swift Package Manager

מוסיפים את מפתח ה-API לנקודת הכניסה הראשית של האפליקציה (או בכל שלב לפני שהמפה נטענת) באופן הבא.

  1. מוסיפים את הצהרת הייבוא הבאה: 
    import GoogleMaps3D
  2. מוסיפים את השיטה הבאה. מחליפים את הערך YOUR_API_KEY במפתח ה-API שלכם. 
    struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

  var body: some View {
    Map(mode: .hybrid)
  }
}

שלב 4 (אופציונלי): בודקים את קובץ מניפסט הפרטיות של אפל

‫Apple דורשת לספק פרטים על מדיניות הפרטיות של אפליקציות ב-App Store.

קובץ המניפסט של אפל בנושא פרטיות נכלל בחבילת המשאבים של ה-SDK. כדי לוודא שקובץ המניפסט של הפרטיות נכלל באפליקציה ולבדוק את התוכן שלו, יוצרים ארכיון של האפליקציה ומפיקים דוח פרטיות מהארכיון.

השלבים הבאים

עכשיו, אחרי שהגדרתם פרויקט בענן ב-Google Cloud, מפתח API ופרויקט Xcode לשימוש עם Maps 3D SDK ל-iOS, אתם יכולים להוסיף מפה תלת-ממדית לאפליקציה.