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

เลือกแพลตฟอร์ม Android iOS

หน้านี้อธิบายวิธีตั้งค่าไลบรารียูทิลิตีสำหรับ Maps SDK สำหรับ iOS

หากต้องการลองใช้ยูทิลิตีเหล่านี้ คุณสามารถเลือกดำเนินการตามวิธีใดวิธีหนึ่งต่อไปนี้

• ติดตั้งไลบรารียูทิลิตีในโปรเจ็กต์ Xcode ที่มีอยู่ เพิ่มยูทิลิตีเหล่านี้ในโปรเจ็กต์ของคุณเอง
• ติดตั้งและเรียกใช้แอปเดโม แอปเดโมเป็นโปรเจ็กต์แบบสแตนด์อโลนที่มีโค้ดทั้งหมดที่จําเป็นสําหรับทดลองใช้ยูทิลิตี

เพิ่มไลบรารียูทิลิตี Maps SDK สำหรับ iOS ลงในโปรเจ็กต์ Xcode

ทำตามขั้นตอนต่อไปนี้เพื่อเพิ่มคลังยูทิลิตีลงในเวิร์กスペース Xcode

ใช้ 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, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '9.0.0'
     pod 'Google-Maps-iOS-Utils', '6.1.0' # 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' ในไฟล์พ็อด

เพิ่มคีย์ API ลงในแอป

ดูวิธีการสร้างคีย์ API และเพิ่มลงในโปรเจ็กต์ Xcode ได้ที่ตั้งค่าโปรเจ็กต์ Xcode

สร้างและเรียกใช้โปรเจ็กต์

หลังจากเพิ่มคีย์ API แล้ว ให้สร้างและเรียกใช้โปรเจ็กต์

ใช้ยูทิลิตีในแอป

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ยูทิลิตีแต่ละรายการในแอปได้จากเอกสารประกอบของยูทิลิตีแต่ละรายการ

• การคลัสเตอร์เครื่องหมาย
• Quadtree
• การแสดงผล KML
• การแสดงผล GeoJSON
• แผนที่ความร้อน

ติดตั้งและเรียกใช้แอปเดโม

ไลบรารียูทิลิตีมีแอปสาธิตที่คุณสามารถติดตั้งและลองใช้ยูทิลิตีแต่ละรายการได้

ติดตั้งแอปเดโม

ใช้ไฟล์จาก 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 เพื่อเปิดโปรเจ็กต์

เพิ่มคีย์ API ลงในแอปเดโม

ในส่วนรับคีย์ API คุณได้สร้างคีย์ API สําหรับแอปแล้ว ให้เพิ่มคีย์นั้นลงในโปรเจ็กต์ Xcode สําหรับแอปเดโม

หมายเหตุ: หากคีย์ API ใช้ข้อจํากัดของแอปพลิเคชัน ให้ตรวจสอบว่าคุณได้เพิ่มตัวระบุ App Bundle ของแอปลงในคีย์แล้ว เช่น หากคุณเรียกใช้แอปสาธิต ตัวระบุ App Bundle จะเป็น com.google.gmsutils.DemoApp ดูข้อมูลเพิ่มเติมเกี่ยวกับการจำกัดคีย์ได้ที่รับคีย์ API

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

สร้างและเรียกใช้แอปเดโม

หลังจากเพิ่มคีย์ API แล้ว ให้สร้างและเรียกใช้โปรเจ็กต์โดยทำดังนี้

• หากใช้เวอร์ชัน Swift ของเดโม คุณจะเลือกยูทิลิตีที่จะดูในแอปได้
• หากคุณใช้เดโมเวอร์ชัน Objective-C คุณจะเห็นเดโมของยูทิลิตีการจัดกลุ่มเครื่องหมาย จากนั้นคุณสามารถแก้ไขเวอร์ชัน Objective-C ของเดโมเพื่อลองใช้ยูทิลิตีแต่ละรายการ ดูข้อมูลเพิ่มเติมได้ที่ส่วนเพิ่มยูทิลิตีลงในแอปด้านล่าง