หน้านี้อธิบายวิธีตั้งค่า ไลบรารีของยูทิลิตี สำหรับ Maps SDK สำหรับ iOS
หากต้องการลองใช้ยูทิลิตีเหล่านี้ คุณสามารถทำอย่างใดอย่างหนึ่งต่อไปนี้
- ติดตั้งไลบรารีของยูทิลิตีลงในโปรเจ็กต์ Xcode ที่มีอยู่ และเพิ่มยูทิลิตีเหล่านี้ในโปรเจ็กต์ของคุณเอง
- ติดตั้งและเรียกใช้แอปเดโม โดยแอปเดโมเป็นโปรเจ็กต์แบบสแตนด์อโลนที่มีโค้ดทั้งหมดที่จำเป็นสำหรับการลองใช้ยูทิลิตี
เพิ่มไลบรารีของยูทิลิตี Maps SDK สำหรับ iOS ลงในโปรเจ็กต์ Xcode
ทำตามขั้นตอนต่อไปนี้เพื่อเพิ่มไลบรารีของยูทิลิตีลงในพื้นที่ทำงาน Xcode
ใช้ Swift Package Manager
- หากยังไม่มีโปรเจ็กต์ Xcode ให้สร้างโปรเจ็กต์ตอนนี้และบันทึกลงในเครื่อง (หากคุณเพิ่งเริ่มพัฒนาแอป iOS ให้สร้างโปรเจ็กต์ใหม่และเลือกเทมเพลตแอป iOS หรือสร้างแอปพลิเคชันมุมมองเดียว ใน Xcode 11.7 หรือเวอร์ชันเก่ากว่า)
- เพิ่ม Maps SDK สำหรับ iOS เป็นการขึ้นต่อกัน ดูตัวเลือกต่างๆ ได้ที่ การติดตั้ง SDK
- ในโปรเจ็กต์ Xcode ให้ไปที่ File -> Swift Packages -> Add Package Dependency
- ในหน้าต่างที่ปรากฏขึ้น ให้ป้อน URL ของที่เก็บไลบรารีของยูทิลิตี Maps SDK สำหรับ iOS
https://github.com/googlemaps/google-maps-ios-utilsแล้วเลือกถัดไป - ในขั้นตอนนี้ ระบบอาจขอให้คุณตรวจสอบสิทธิ์ด้วยบัญชี GitHub ทำตามวิธีการเพื่อสร้างโทเค็นเพื่อการเข้าถึงส่วนบุคคลของ GitHub เพื่อดำเนินการต่อ
- ในหน้าต่างถัดไป ให้เลือกตัวเลือกวิทยุเวอร์ชัน เลือกสูงสุดเป็นเวอร์ชันหลักถัดไป จากรายการแบบเลื่อนลง แล้วป้อนเวอร์ชันล่าสุดของไลบรารีของยูทิลิตี Maps SDK สำหรับ iOS (เช่น "6.0.0")
- คลิกเมนูแบบเลื่อนลงข้างเพิ่มลงในโปรเจ็กต์ เลือกโปรเจ็กต์ แล้วเลือกเพิ่มแพ็กเกจ
เพิ่มคีย์ API ลงในแอป
ดูวิธีการสร้างคีย์ API และเพิ่มคีย์ดังกล่าวลงในโปรเจ็กต์ Xcode ได้ที่ตั้งค่าโปรเจ็กต์ Xcodeสำหรับคำแนะนำในการสร้าง คีย์ API และเพิ่มคีย์ดังกล่าวลงในโปรเจ็กต์ Xcodeสร้างและเรียกใช้โปรเจ็กต์
หลังจากเพิ่มคีย์ API แล้ว ให้สร้างและเรียกใช้โปรเจ็กต์
ใช้ยูทิลิตีในแอป
ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ยูทิลิตีในแอปได้ในเอกสารประกอบของยูทิลิตีแต่ละรายการ ดังนี้
ติดตั้งและเรียกใช้แอปเดโม
ไลบรารีของยูทิลิตีมีแอปเดโมที่คุณสามารถติดตั้งแล้วลองใช้ยูทิลิตีแต่ละรายการได้
วิธีติดตั้งแอปเดโมใช้ไฟล์จาก GitHub
- ดาวน์โหลด
ไฟล์เก็บถาวรของตัวอย่างโค้ดจาก
GitHub
แล้วแตกไฟล์เก็บถาวร หรือโคลนที่เก็บลงในไดเรกทอรีในเครื่องโดยใช้คำสั่งต่อไปนี้
git clone https://github.com/googlemaps/google-maps-ios-utils.git
- เปิดหน้าต่างเทอร์มินัล ไปที่ไดเรกทอรีที่คุณแตกไฟล์ตัวอย่าง แล้ว
เจาะลึกลงไปในไดเรกทอรีตัวอย่างที่เหมาะสมสำหรับภาษาที่ต้องการใช้
Swift
cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeprojObjective-C
cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj
เพิ่มคีย์ API ลงในแอปเดโม
ในรับคีย์ API คุณจะสร้าง คีย์ API สำหรับแอป ตอนนี้ให้เพิ่มคีย์ดังกล่าวลงในโปรเจ็กต์ Xcode สำหรับแอปเดโม ได้ที่รับคีย์ APISwift
เพิ่มคีย์ API ลงใน AppDelegate.swift ดังนี้
- เพิ่มคำสั่งนำเข้าต่อไปนี้
import GoogleMaps
- แก้ไขบรรทัดต่อไปนี้เพื่อเพิ่มคีย์ API ระหว่างเครื่องหมายคำพูดคู่
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
เพิ่มคีย์ API ลงใน AppDelegate.m ดังนี้
- เพิ่มคำสั่งนำเข้าต่อไปนี้
@import GoogleMaps;
- แก้ไขบรรทัดต่อไปนี้เพื่อเพิ่มคีย์ 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 เพื่อลองใช้ยูทิลิตีแต่ละรายการได้ ดูข้อมูลเพิ่มเติมได้ที่ส่วนเพิ่มยูทิลิตีลงในแอปด้านล่าง