การตั้งค่าและการสาธิต

ใช้ Swift Package Manager

1. หากคุณยังไม่มีโปรเจ็กต์ Xcode ให้สร้างโปรเจ็กต์เลยและบันทึกลงในเครื่อง (หากคุณเพิ่งเริ่มพัฒนา iOS ให้สร้างโปรเจ็กต์ใหม่และเลือกเทมเพลตแอป iOS ใน Xcode 11.7 หรือเก่ากว่า ให้สร้างแอปพลิเคชันมุมมองเดียว)
2. เพิ่ม Maps SDK สำหรับ iOS เป็น Dependency ดูตัวเลือกได้ที่หัวข้อการติดตั้ง SDK
3. ในโปรเจ็กต์ Xcode ให้ไปที่ไฟล์ -> Swift Packages -> เพิ่ม Package Dependency
4. ในหน้าต่างที่ปรากฏขึ้น ให้ป้อน URL ของที่เก็บไลบรารียูทิลิตี Maps SDK สําหรับ iOS https://github.com/googlemaps/google-maps-ios-utils แล้วเลือกถัดไป
• เมื่อถึงขั้นตอนนี้ คุณอาจได้รับข้อความแจ้งให้ตรวจสอบสิทธิ์ด้วยบัญชี GitHub ทําตามวิธีการเพื่อสร้างโทเค็นการเข้าถึงส่วนบุคคลของ GitHub เพื่อดําเนินการต่อ
5. ในหน้าต่างถัดไป ให้เลือกตัวเลือกช่องทำเครื่องหมายเวอร์ชัน เลือกอัปเดตเป็นเวอร์ชันหลักถัดไปจากรายการแบบเลื่อนลง แล้วป้อนเวอร์ชันล่าสุดของไลบรารียูทิลิตี Maps SDK สำหรับ iOS (เช่น "6.0.0")
6. คลิกเมนูแบบเลื่อนลงข้างเพิ่มลงในโปรเจ็กต์ เลือกโปรเจ็กต์ แล้วเลือกเพิ่มแพ็กเกจ

ใช้ CocoaPods

1. หากยังไม่มีโปรเจ็กต์ Xcode ให้สร้างโปรเจ็กต์เลยและบันทึกลงในเครื่อง (หากคุณเพิ่งเริ่มพัฒนา iOS ให้สร้างแอปพลิเคชันแบบหน้าเดียว)
2. หากยังไม่มีไฟล์พ็อดสำหรับโปรเจ็กต์ ให้สร้างไฟล์ชื่อ Podfile ในไดเรกทอรีโปรเจ็กต์ ไฟล์นี้จะกำหนดข้อกำหนดของโปรเจ็กต์
3. แก้ไขไฟล์ Pod ของโปรเจ็กต์และเพิ่มพึ่งพาในพ็อด Google-Maps-iOS-Utils ต่อไปนี้เป็นตัวอย่างที่รวม Dependency ที่จําเป็นสําหรับ Maps SDK สําหรับ iOS และไลบรารียูทิลิตี

   source 'https://github.com/CocoaPods/Specs.git'
   platform :ios, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '10.0.0'
     pod 'Google-Maps-iOS-Utils', '6.1.3' # x-release-please-version
   end

4. เรียกใช้ pod install
5. ปิด Xcode แล้วเปิด (ดับเบิลคลิก) ไฟล์ .xcworkspace ของโปรเจ็กต์เพื่อเปิด Xcode นับจากนี้ไป คุณต้องใช้ไฟล์ .xcworkspace เพื่อเปิดโปรเจ็กต์

หมายเหตุ: ยูทิลิตีการจัดกลุ่มเครื่องหมายจะขึ้นอยู่กับ Quadtree แต่คุณใช้ Quadtree ได้โดยไม่ต้องจัดกลุ่มเครื่องหมาย หากต้องการใช้เฉพาะยูทิลิตี Quadtree ให้เปลี่ยน pod 'Google-Maps-iOS-Utils' เป็น 'Google-Maps-iOS-Utils/QuadTree' ในไฟล์พ็อด

ใช้ไฟล์จาก GitHub

1. ดาวน์โหลดไฟล์เก็บตัวอย่างโค้ดจาก GitHub แล้วแตกไฟล์เก็บ
2. เปิดหน้าต่างเทอร์มินัล ไปที่ไดเรกทอรีที่คุณขยายไฟล์ตัวอย่าง แล้วเจาะลึกลงในไดเรกทอรีตัวอย่างที่เหมาะสมสำหรับภาษาที่ต้องการใช้ ดังนี้
   • สําหรับ Swift ให้เรียกใช้ cd google-maps-ios-utils-master/samples/SwiftDemoApp
   • สําหรับ Objective-C ให้เรียกใช้ cd google-maps-ios-utils-master/samples/ObjCDemoApp
3. เรียกใช้คำสั่งต่อไปนี้
   

   pod install

4. ปิด Xcode แล้วเปิด (ดับเบิลคลิก) ไฟล์ .xcworkspace ของโปรเจ็กต์เพื่อเปิด Xcode นับจากนี้เป็นต้นไป คุณต้องใช้ไฟล์ .xcworkspace เพื่อเปิดโปรเจ็กต์

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 = @"";