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

เลือกแพลตฟอร์ม แอนดรอยด์ iOS

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

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

เพิ่ม Maps SDK สำหรับ iOS Utility Library ไปยังโปรเจ็กต์ Xcode

ทำตามขั้นตอนต่อไปนี้เพื่อเพิ่มไลบรารียูทิลิตีลงในพื้นที่ทำงานของ Xcode

ใช้ 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 แล้วเลือกถัดไป
  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' ในไฟล์พ็อด

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

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

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

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

ใช้ยูทิลิตีในแอปของคุณ

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

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

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

ติดตั้งแอปเดโมโดยใช้ 1 ใน 2 วิธีต่อไปนี้

ใช้ไฟล์จาก 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

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

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

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 ของเดโมเพื่อลองใช้ยูทิลิตีแต่ละอย่าง ดูข้อมูลเพิ่มเติมในส่วนเพิ่มยูทิลิตีลงในแอปของคุณด้านล่าง