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

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

• 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 เมื่อคุณสร้างคำขอการ์ดครั้งต่อๆ ไป API ไทล์ 3 มิติ จะระบุพารามิเตอร์ 2 รายการต่อไปนี้

session

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

key

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

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

การระบุแหล่งที่มาหมายถึงการยอมรับแหล่งที่มาของชิ้นส่วนแผนที่ และเป็นข้อกำหนดในการใช้ 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 หรือไม่