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

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בחירת פלטפורמה: Android iOS JavaScript

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

אפשר לנסות את הדגמות ה-SDK באמצעות CocoaPods

ה-SDK של מקומות ל-iOS זמין כ-CocoaPods. CocoaPods הוא מנהל קוד פתוח של תלות בפרויקטים של Swift ו-Object-C.

ה-SDK של מקומות ל-iOS מספק קבוצה של אפליקציות להדגמה של SDK שאפשר להתקין ולהפעיל באמצעות הפקודה pod try:

כדי להתקין את CocoaPods ולנסות את ה-SDK של מקומות ל-iOS:

  1. אם הכלי CocoaPods עדיין לא מותקן, אפשר להתקין אותו ב-macOS על ידי הרצת הפקודה הבאה מהמסוף. לפרטים נוספים אפשר לעיין במדריך לתחילת העבודה של CocoaPods.
    sudo gem install cocoapods
  2. מורידים את הקבצים לדוגמה באחת משתי השיטות הבאות:

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

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

      Swift

      cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift

      Objective-C

      cd maps-sdk-for-ios-samples-master/GooglePlaces
    3. מריצים את הפקודה הבאה:
      pod install
      open GooglePlacesDemos.xcworkspace

    שימוש ב-CocoaPods גרסה 1.6.1

    1. פותחים חלון טרמינל ומתקינים את גרסה 1.6.1:
      sudo gem install cocoapods -v1.6.1
    2. אחזור הקבצים של מקומות Google באמצעות Cocoapods:
      pod try GooglePlaces

      CocoaPods מעדכן את מאגרי המפרט, ולאחר מכן פותח את הדגמות ה-SDK בפרויקט Xcode זמני GooglePlacesDemos.xcworkspace.

  3. מפעילים את ה-SDK של מקומות ל-iOS בפרויקט ב-Google Cloud Console.
  4. אם עדיין אין לך מפתח API, יש לפעול לפי ההוראות כדי להגדיר פרויקט ב-Cloud Console ולקבל מפתח API. כשמגדירים את המפתח ב-Cloud Console, אפשר לציין את מזהה החבילה של האפליקציה כדי להבטיח שרק האפליקציה תוכל להשתמש במפתח. מזהה החבילה המוגדר כברירת מחדל באפליקציה של דוגמאות ה-SDK הוא com.example.GooglePlacesDemos.
  5. צריך לערוך את הקובץ SDKDemoAPIKey ולהדביק את מפתח ה-API בקבוע הנכון. למשל:

    Swift

    let placesAPIKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. אם מוצגת בקשה מ-Xcode לבטל את הנעילה של קובץ SDKDemoAPIKey, יש לבחור באפשרות ביטול נעילה.
  7. אם מופיעה, יש להסיר את השורה הבאה, מפני שהיא משמשת לרישום הבעיה:

    Swift

    #error (הרשמה למפתח API והוספה לכאן. לאחר מכן, יש למחוק את השורה.")

    Objective-C

    #error Register your API key and insert here, then delete this line.
  8. יוצרים ומפעילים מחדש את הפרויקט.
  9. אם גרסת ה-build נכשלה או שהאפליקציה קורסת עם שגיאה לגבי מפתח ה-API בזמן ההפעלה הראשונה, חשוב לוודא שסיפקת את המפתחות הדרושים בקובץ SDKDemoAPIKey.
  10. אם מפעילים את הדגמות של מקומות Google, חלון הסימולטור של iOS יציג רשימה של הדגמות של מקומות.
  11. אם מתבקשים לאפשר ל-Google PlacesDemos לגשת אל המיקום, בוחרים באפשרות Allow (אישור).
  12. הדוגמה שבחרת מוכנה להפעלה.

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

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