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

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

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

התנסות בהדגמות ה-SDK באמצעות CocoaPods

Places SDK ל-iOS זמין בתור pod של CocoaPods. CocoaPods הוא מנהל יחסי תלות של קוד פתוח לפרויקטים של Swift ו-Objective-C Cocoa.

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

• ב-GooglePlaces מוצגות השלמה אוטומטית של מקומות ותמונות של מקומות.

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

1. אם הכלי CocoaPods עוד לא מותקן, מריצים את הפקודה הבאה מהטרמינל כדי להתקין אותו ב-macOS. לפרטים נוספים אפשר לעיין במדריך לתחילת העבודה של CocoaPods.

   sudo gem install cocoapods

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

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

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

      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 v1.6.1

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

      sudo gem install cocoapods -v1.6.1

   2. מאחזרים את הקבצים מ-Google Places באמצעות Cocoapods:

      pod try GooglePlaces

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

3. מפעילים את Places SDK ל-iOS לפרויקט במסוף Google Cloud.
4. אם עדיין אין לכם מפתח API, בצעו את instructions כדי להגדיר פרויקט במסוף Cloud ולקבל מפתח API. כשמגדירים את המפתח במסוף Cloud, אפשר לציין את מזהה החבילה של האפליקציה כדי להבטיח שרק האפליקציה תוכל להשתמש במפתח. מזהה החבילה שמוגדר כברירת מחדל באפליקציה לדוגמה של ה-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 לעריכה, בוחרים באפשרות Unlock.
7. אם השורה הבאה מופיעה, מסירים אותה כי היא משמשת לרישום הבעיה:

   Swift

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

   Objective-C

   #error Register your API key and insert here, then delete this line.

8. בונים ומפעילים שוב את הפרויקט.
9. אם ה-build נכשל או אם האפליקציה קורסת ומוצגת שגיאה לגבי מפתח ה-API בהרצה הראשונה, חשוב לוודא שסיפקת את המפתחות שנדרשים בקובץ SDKDemoAPIKey.
10. אם אתם מפעילים את ההדגמות של GooglePlaces, בחלון הסימולטור של iOS תוצג רשימה של מקומות הדגמה.
11. אם מוצגת בקשה לתת ל-GooglePlacesDemos גישה למיקום, צריך לבחור באפשרות Allow (אישור).
12. הדוגמה שבחרת מוכנה עכשיו להצגה.

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

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