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

เลือกแพลตฟอร์ม: 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 เป็นการขึ้นต่อกัน ดูตัวเลือกต่างๆ ได้ที่ การติดตั้ง SDK
3. ในโปรเจ็กต์ Xcode ให้ไปที่ File -> Swift Packages -> Add 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. คลิกเมนูแบบเลื่อนลงข้างเพิ่มลงในโปรเจ็กต์ เลือกโปรเจ็กต์ แล้วเลือกเพิ่มแพ็กเกจ

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

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

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

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

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

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

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

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

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

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

ใช้ไฟล์จาก GitHub

1. ดาวน์โหลด ไฟล์เก็บถาวรของตัวอย่างโค้ดจาก GitHub แล้วแตกไฟล์เก็บถาวร หรือโคลนที่เก็บลงในไดเรกทอรีในเครื่องโดยใช้คำสั่งต่อไปนี้

   git clone https://github.com/googlemaps/google-maps-ios-utils.git

2. เปิดหน้าต่างเทอร์มินัล ไปที่ไดเรกทอรีที่คุณแตกไฟล์ตัวอย่าง แล้ว เจาะลึกลงไปในไดเรกทอรีตัวอย่างที่เหมาะสมสำหรับภาษาที่ต้องการใช้

   Swift

   cd google-maps-ios-utils/samples/SwiftDemoApp
   open SwiftDemoApp.xcodeproj

   Objective-C

   cd google-maps-ios-utils/samples/ObjCDemoApp
   open ObjCDemoApp.xcodeproj

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

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

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