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

ใช้ Swift Package Manager

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

ใช้ CocoaPods

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

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

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

หมายเหตุ: ยูทิลิตีการจัดกลุ่มเครื่องหมายจะขึ้นอยู่กับ รูปสี่เหลี่ยมด้านบน แต่คุณสามารถใช้รูปสี่เหลี่ยมจตุรัสได้โดยไม่จัดกลุ่มเครื่องหมาย หากคุณต้องการ เฉพาะยูทิลิตี 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 เพื่อเปิดโปรเจ็กต์

ใช้ CocoaPods v1.6.1

1. เปิดหน้าต่างเทอร์มินัลและติดตั้งเวอร์ชัน 1.6.1

   sudo gem install cocoapods -v1.6.1

2. ดึงไฟล์ Google Maps โดยใช้ Cocoapods:

   pod try Google-Maps-iOS-Utils

   เลือก Swift หรือ Objective-C เมื่อมีข้อความแจ้ง CocoaPods จะอัปเดตที่เก็บข้อมูลจำเพาะของคุณ จากนั้นเปิดการสาธิตในโปรเจ็กต์ Xcode ชั่วคราวชื่อ SwiftDemoApp.xcodeproj หรือ ObjCDemoApp.xcodeproj

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