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

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

• URL ของเนื้อหา
• คำขอและการตอบกลับ
• แสดงการระบุแหล่งที่มาของข้อมูล

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 ทำ