ตั้งค่า

ผลิตภัณฑ์หรือฟีเจอร์นี้เป็นเวอร์ชันทดลอง (ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป) ผลิตภัณฑ์และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจมีการรองรับที่จำกัด และการเปลี่ยนแปลงผลิตภัณฑ์และ ฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจไม่เข้ากันกับผลิตภัณฑ์และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอื่นๆ ข้อเสนอก่อนเปิดให้ใช้งานทั่วไปอยู่ภายใต้ข้อกำหนดเฉพาะบริการของ Google Maps Platform ดูข้อมูลเพิ่มเติมได้ที่คำอธิบายเกี่ยวกับระยะการเปิดตัว

หน้านี้อธิบายสิ่งที่คุณต้องทำเพื่อตั้งค่าให้พร้อมเริ่มสร้างด้วย Maps 3D SDK สำหรับ iOS กระบวนการตั้งค่าเกี่ยวข้องกับการกำหนดค่าโปรเจ็กต์และ API ของ Google Cloud เพื่อใช้กับ SDK จากนั้นจึงตั้งค่าโปรเจ็กต์ Xcode ทำตามขั้นตอนเหล่านี้ก่อนเพิ่มแผนที่ 3 มิติแรกในแอป

ตั้งค่าโปรเจ็กต์ Google Cloud และคีย์ API

ก่อนที่จะเริ่มสร้างด้วย Maps 3D SDK สำหรับ iOS คุณต้องตั้งค่าโปรเจ็กต์ Google Cloud และคีย์ API เพื่อใช้กับ Maps 3D SDK สำหรับ iOS โดยทำตามขั้นตอนต่อไปนี้

ขั้นตอนที่ 1

คอนโซล

1. ใน Google Cloud Console ให้คลิกสร้างโปรเจ็กต์ในหน้าตัวเลือกโปรเจ็กต์เพื่อเริ่มสร้างโปรเจ็กต์ Cloud ใหม่

   ไปที่หน้าเครื่องมือเลือกโปรเจ็กต์

2. ตรวจสอบว่าได้เปิดใช้การเรียกเก็บเงินสำหรับโปรเจ็กต์ Cloud แล้ว ยืนยันว่าโปรเจ็กต์เปิดใช้การเรียกเก็บเงินแล้ว

   Google Cloud มีข้อเสนอในการทดลองใช้แบบไม่มีค่าใช้จ่าย ช่วงทดลองใช้จะหมดอายุเมื่อครบ 90 วันหรือหลังจากที่บัญชีมียอดเรียกเก็บเงินสะสมถึง $300 แล้วแต่ว่ากรณีใดจะเกิดขึ้นก่อน ยกเลิกได้ทุกเมื่อ ดูข้อมูลเพิ่มเติมได้ที่ เครดิตบัญชีสำหรับการเรียกเก็บเงินและการเรียกเก็บเงิน

Cloud SDK

gcloud projects create "PROJECT"

อ่านเพิ่มเติมเกี่ยวกับ Google Cloud SDK , การติดตั้ง Cloud SDK และคำสั่งต่อไปนี้

• gcloud projects create

หมายเหตุ: หากไม่ต้องการเก็บทรัพยากรที่สร้างขึ้น ในแบบฝึกหัดการเรียนรู้ ให้สร้างโปรเจ็กต์แทนการเลือกโปรเจ็กต์ที่มีอยู่ หลังจากทำแบบฝึกหัดเสร็จแล้ว คุณจะลบโปรเจ็กต์ซึ่งเป็นการนำทรัพยากรทั้งหมดที่เชื่อมโยงกับโปรเจ็กต์นี้ออกได้

ขั้นตอนที่ 2

หากต้องการใช้ Google Maps Platform คุณต้องเปิดใช้ API หรือ SDK ที่วางแผนจะใช้กับโปรเจ็กต์

โปรดทราบว่าการผสานรวมบางอย่างกำหนดให้คุณต้องเปิดใช้ API/SDK หลายรายการ หากไม่แน่ใจว่าจะเปิดใช้ API หรือ SDK ใด ให้ลองใช้ตัวเลือก API หรืออ่านเอกสารประกอบสำหรับ API/SDK ที่ต้องการใช้

วิธีเปิดใช้ API หรือ SDK อย่างน้อย 1 รายการ

คอนโซล

1. ดู API และ SDK ของ Google Maps Platform ที่คุณเปิดใช้ได้โดยไปที่หน้าคลัง API ของ Maps ในคอนโซล Cloud

   ไปที่หน้าคลัง Maps API

2. คลิก API หรือ SDK ที่ต้องการเปิดใช้
   • หากปุ่มระบุว่าเปิดใช้ ให้คลิกปุ่มเพื่อเปิดใช้ API หรือ SDK
   • หากปุ่มระบุว่าจัดการ แสดงว่าได้เปิดใช้ API หรือ SDK แล้ว และคุณ ไม่จำเป็นต้องดำเนินการใดๆ เพิ่มเติม
   • การคลิกปุ่มใดปุ่มหนึ่งจะแสดง แดชบอร์ดสำหรับ API หรือ SDK (คลิกปุ่มปิดใช้ เพื่อนำ API หรือ SDK ออกจากโปรเจ็กต์นี้)

Cloud SDK

คำสั่งต่อไปนี้จะเปิดใช้ Maps, Routes และ Places API ทั้งหมด

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

อ่านเพิ่มเติมเกี่ยวกับ Google Cloud SDK , การติดตั้ง Cloud SDK และคำสั่งต่อไปนี้

• gcloud services enable
• gcloud services disable

ใช้คำสั่งต่อไปนี้เพื่อเปิดใช้ Environment API

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

หมายเหตุ: การเปิดใช้ Places API จะเป็นการเปิดใช้ Places Library, Maps JavaScript API, Places SDK สำหรับ Android และ Places SDK สำหรับ iOS ด้วย

ขั้นตอนที่ 3

ขั้นตอนนี้จะอธิบายเฉพาะกระบวนการสร้างคีย์ API หากคุณใช้คีย์ API ใน เวอร์ชันที่ใช้งานจริง เราขอแนะนำอย่างยิ่งให้จำกัดคีย์ API คุณดูข้อมูลเพิ่มเติมได้ในหน้าการใช้คีย์ API สำหรับผลิตภัณฑ์นั้นๆ

คีย์ API คือตัวระบุที่ไม่ซ้ำกันซึ่งตรวจสอบสิทธิ์คำขอที่เชื่อมโยงกับโปรเจ็กต์ของคุณเพื่อวัตถุประสงค์ในการใช้งานและการเรียกเก็บเงิน คุณต้องมีคีย์ API อย่างน้อย 1 คีย์ที่เชื่อมโยงกับโปรเจ็กต์

วิธีสร้างคีย์ API

คอนโซล

1. ไปที่หน้า Google Maps Platform > ข้อมูลเข้าสู่ระบบ

   ไปที่หน้าข้อมูลเข้าสู่ระบบ

2. ในหน้าข้อมูลเข้าสู่ระบบ ให้คลิกสร้างข้อมูลเข้าสู่ระบบ > คีย์ API
   กล่องโต้ตอบสร้างคีย์ API แล้วจะแสดงคีย์ API ที่สร้างขึ้นใหม่
3. คลิกปิด
   คีย์ API ใหม่จะแสดงอยู่ในหน้าข้อมูลเข้าสู่ระบบในส่วนคีย์ API
   (อย่าลืมจำกัดคีย์ API ก่อนนำไปใช้ในเวอร์ชันที่ใช้งานจริง)

Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

อ่านเพิ่มเติมเกี่ยวกับ Google Cloud SDK , การติดตั้ง Cloud SDK และคำสั่งต่อไปนี้

• gcloud services api-keys create

หากต้องการเปิดใช้ SDK โปรดดูหน้าMaps 3D SDK สำหรับ iOS ใน Google Cloud Console ดูข้อมูลเพิ่มเติมเกี่ยวกับการทำตามขั้นตอนเหล่านี้ได้ที่เริ่มต้นใช้งาน Google Maps Platform

ตั้งค่าโปรเจ็กต์ Xcode

ส่วนนี้จะอธิบายวิธีสร้างและกำหนดค่าโปรเจ็กต์ Xcode เพื่อใช้กับ Maps 3D SDK สำหรับ iOS

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

ขั้นตอนที่ 1: ติดตั้งซอฟต์แวร์ที่จำเป็น

หากต้องการสร้างโปรเจ็กต์โดยใช้ Maps 3D SDK สำหรับ iOS คุณต้องดาวน์โหลดและติดตั้งสิ่งต่อไปนี้

• Xcode เวอร์ชัน 16.0 ขึ้นไป

ขั้นตอนที่ 2: สร้างโปรเจ็กต์ Xcode และติดตั้ง Maps 3D SDK สำหรับ iOS

Swift Package Manager

คุณติดตั้ง Maps 3D SDK สำหรับ iOS ได้โดยใช้ Swift Package Manager

หากต้องการเพิ่ม SDK ลงในโปรเจ็กต์ใหม่หรือที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้

• เปิด Xcode project หรือ workspace แล้วไปที่ไฟล์ > เพิ่มการอ้างอิงแพ็กเกจ
• ป้อน https://github.com/googlemaps/ios-maps-3d-sdk เป็น URL แล้วกด Enter เพื่อดึงแพ็กเกจ จากนั้นคลิก "เพิ่มแพ็กเกจ"
• จากหน้าต่างเลือกผลิตภัณฑ์ในแพ็กเกจ ให้ตรวจสอบว่าระบบจะเพิ่ม GoogleMaps3D ลงในเป้าหมายหลักที่กำหนด เมื่อดำเนินการเสร็จแล้ว ให้คลิกเพิ่มแพ็กเกจ
• หากต้องการยืนยันการติดตั้ง ให้ไปที่แผงทั่วไปของเป้าหมาย ในเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง คุณควรเห็นแพ็กเกจที่ติดตั้ง นอกจากนี้ คุณยังดูส่วนการขึ้นต่อกันของแพ็กเกจในProject Navigator เพื่อยืนยันแพ็กเกจและเวอร์ชันได้ด้วย

ขั้นตอนที่ 3: เพิ่มคีย์ API ลงในแอป

Swift Package Manager

เพิ่มคีย์ API ไปยังจุดแรกเข้าหลักของแอป (หรือเมื่อใดก็ได้ก่อนที่แผนที่จะโหลด) ดังนี้

1. เพิ่มคำสั่งนำเข้าต่อไปนี้

   import GoogleMaps3D

2. เพิ่มวิธีการต่อไปนี้ แทนที่ YOUR_API_KEY ด้วยคีย์ API ของคุณ

   struct ContentView: View {
     init () {
       Map.apiKey = "YOUR_API_KEY"
     }
   
     var body: some View {
       Map(mode: .hybrid)
     }
   }
       

คีย์ API จะปรากฏในจุดแรกเข้าของแอปหรือแยกกันสำหรับแต่ละมุมมองแผนที่ แต่หากระบุคีย์ API ทั้งในจุดแรกเข้าและมุมมองแผนที่ คอนโซลจะแสดงข้อผิดพลาด

ขั้นตอนที่ 4 (ไม่บังคับ): ตรวจสอบไฟล์ Apple Privacy Manifest

หมายเหตุ: ข้อมูลต่อไปนี้เกี่ยวข้องเมื่อคุณติดตั้งใช้งานแอปในเว็บสโตร์

Apple กําหนดให้แอปใน App Store ต้องมีรายละเอียดความเป็นส่วนตัวของแอป

ไฟล์ Apple Privacy Manifest จะรวมอยู่ในแพ็กเกจทรัพยากรสำหรับ SDK หากต้องการยืนยันว่าได้รวมไฟล์ Manifest ความเป็นส่วนตัวแล้ว และตรวจสอบเนื้อหาของไฟล์ ให้สร้างที่เก็บถาวรของแอปและสร้างรายงานความเป็นส่วนตัว จากที่เก็บถาวร

ขั้นตอนถัดไป

ตอนนี้คุณได้ตั้งค่าโปรเจ็กต์ Google Cloud, คีย์ API และโปรเจ็กต์ Xcode เพื่อใช้กับ Maps 3D SDK สำหรับ iOS แล้ว คุณก็เพิ่มแผนที่ 3 มิติลงใน แอปได้