ทํางานกับตัวแสดงผลการ์ด 3 มิติของคุณเอง

หากคุณไม่สามารถรวมผลิตภัณฑ์แสดงภาพของบุคคลที่สามลงใน คุณอาจต้องสร้างตัวแสดงผลการ์ด 3 มิติขึ้นมาเอง ช่วงเวลานี้ คุณต้องพิจารณาปัจจัยสำคัญต่อไปนี้

URL เนื้อหา

เมื่อแสดงชิ้นส่วนภาพ 3 มิติแบบภาพเสมือนจริง Maps Tiles API จะแสดง URI สำหรับ ชุดการ์ดสำหรับเด็ก URI ของชุดไทล์เหล่านี้ไม่ใช่ URL แบบปกติ โดยประกอบด้วย คอมโพเนนต์เส้นทางและพารามิเตอร์ เนื่องจากไม่มีคีย์ API ซึ่งก็คือ ที่จำเป็นต่อการให้สิทธิ์คำขอของคุณ สำหรับข้อมูลเพิ่มเติม โปรดดู ข้อกำหนดเฉพาะสำหรับภาพ 3 มิติ

คำขอและการตอบกลับ

ต่อไปนี้เป็นตัวอย่างบางส่วนของคำขอและการตอบกลับชิ้นส่วนภาพ 3 มิติแบบสมจริง คุณ โปรดตรวจสอบโดยใช้เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ Chrome

ตัวอย่างคำขอชุดไทล์รูท:

https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY

ตัวอย่าง URI การตอบกลับชุดไทล์:

 /v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg

ตัวอย่าง URL คำขอของชิ้นส่วนแผนที่ใช้โดยโหมดแสดงภาพ

https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY
https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYubm9k.glb?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY

คุณควรแนบพารามิเตอร์ที่ปรากฏใน URI ชุดไทล์ร่วมกับ API เมื่อคุณสร้างคำขอการ์ดครั้งต่อๆ ไป API ไทล์ 3 มิติ จะระบุพารามิเตอร์ 2 รายการต่อไปนี้

session
ตัวระบุในตัวสำหรับเซสชันการโหลดแบบ 3 มิติ สร้างขึ้นโดยอัตโนมัติ API กัน ต้องแนบโดยตัวแสดงผลเมื่อสร้าง คำขอไทล์
key
คีย์ API ที่คุณใช้เข้าถึงบริการการ์ด 3 มิติ คุณต้องแนบเอกสารกับ คำขอไทล์ที่ตามมาทั้งหมด

การระบุแหล่งที่มาของดิสเพลย์

การระบุแหล่งที่มาหมายถึงการรับทราบแหล่งที่มาของชิ้นส่วนแผนที่และเป็นข้อกำหนดสำหรับ การใช้ API นี้ ซึ่งรวมถึงการระบุแหล่งที่มาของแบรนด์ Google (โลโก้) และ การระบุแหล่งที่มาของข้อมูล โลโก้ Google ที่คุณสามารถใช้ได้บน หน้านโยบาย Map Tiles API ข้อมูล ข้อมูลการระบุแหล่งที่มาจะแสดงผลในทุกการตอบสนองของไทล์ ลองค้นหาได้ใน เนื้อหาการตอบกลับใน JSON ภายใต้ asset.copyright

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

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

  1. ดึงข้อมูลลิขสิทธิ์ทั้งหมดจากไทล์ทั้งหมดในมุมมอง

  2. และคั่นแหล่งที่มาของลิขสิทธิ์หลายแหล่งด้วยเครื่องหมายเซมิโคลอน

  3. จัดเรียงข้อมูลตามจำนวนการเกิดเหตุการณ์

  4. แสดงแหล่งที่มาของลิขสิทธิ์บนหน้าจอ โดยเรียงลำดับจากเหตุการณ์ส่วนใหญ่จนถึง น้อยที่สุด คล้ายกับวิธี Google Earth หรือไม่