ตั้งค่า

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

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

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

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

ขั้นตอนที่ 1

คอนโซล

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

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

2. ตรวจสอบว่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์เปิดใช้การเรียกเก็บเงินแล้ว ยืนยันว่าโปรเจ็กต์เปิดใช้การเรียกเก็บเงินแล้ว

   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 ใด ให้ลองใช้ Capabilities Explorer หรือดูเอกสารประกอบสำหรับ API/SDK ที่ต้องการใช้

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

คอนโซล

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

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

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

Cloud SDK

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

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

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

ขั้นตอนที่ 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 หากต้องการยืนยันว่าได้รวมไฟล์ Privacy Manifest แล้วและตรวจสอบเนื้อหาของไฟล์ ให้สร้างที่เก็บถาวรของแอปและ สร้างรายงานความเป็นส่วนตัว จากที่เก็บถาวร

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

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