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

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

URL ของเนื้อหา

เมื่อแสดงชิ้นส่วนแผนที่ 3 มิติแบบสมจริง Map 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 เมื่อสร้างคำขอไทล์ในภายหลัง 3D Tiles API มี 2 พารามิเตอร์ต่อไปนี้

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

การระบุแหล่งที่มาของการแสดงผล

การระบุแหล่งที่มาหมายถึงการยอมรับแหล่งที่มาของชิ้นส่วนแผนที่ และเป็นข้อกำหนดในการใช้ API นี้ ซึ่งรวมถึงการระบุแหล่งที่มาของแบรนด์ (โลโก้) ของ Google และการระบุแหล่งที่มาของข้อมูล โลโก้ Google มีอยู่ในหน้านโยบาย Map Tiles API ระบบจะแสดงข้อมูลการระบุแหล่งที่มาของข้อมูลในการตอบกลับของการ์ดทุกรายการ มองหาในการ์ด glTF ในส่วน 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 แสดง