สิ่งที่ควรรู้ก่อนเริ่มต้น

เอกสารนี้อธิบายข้อกำหนดเบื้องต้น แนวทางปฏิบัติแนะนำ และข้อผิดพลาดที่พบบ่อยเมื่อใช้ชุดข้อมูล

ข้อกำหนดเบื้องต้น

เมื่อสร้างชุดข้อมูล

  • ชื่อที่แสดงต้องไม่ซ้ำกันภายในโปรเจ็กต์ Google Cloud
  • ชื่อที่แสดงต้องมีความยาวไม่เกิน 64 ไบต์ (เนื่องจากอักขระเหล่านี้แสดงใน UTF-8, ในบางภาษาอักขระแต่ละตัวอาจแสดงด้วยหลายไบต์)
  • คำอธิบายต้องมีความยาวไม่เกิน 1,000 ไบต์

เมื่ออัปโหลดข้อมูล

  • ประเภทไฟล์ที่รองรับคือ CSV, GeoJSON และ KML
  • ขนาดไฟล์สูงสุดที่รองรับคือ 500 MB
  • ชื่อคอลัมน์แอตทริบิวต์ต้องไม่ขึ้นต้นด้วยสตริง "?_"
  • ระบบไม่รองรับรูปทรงเรขาคณิต 3 มิติ ซึ่งรวมถึงคำต่อท้าย "Z" ในรูปแบบ WKT และพิกัดความสูงในรูปแบบ GeoJSON

แนวทางปฏิบัติแนะนำในการเตรียมข้อมูล

หากข้อมูลต้นทางมีความซับซ้อนหรือมีขนาดใหญ่ เช่น จุดหนาแน่น เส้นยาว หรือรูปหลายเหลี่ยม (โดยปกติแล้วไฟล์ต้นทางที่มีขนาดใหญ่กว่า 50 MB จะอยู่ในหมวดหมู่นี้) ให้ลองลดความซับซ้อนของข้อมูลก่อนอัปโหลดเพื่อให้ได้ประสิทธิภาพที่ดีที่สุดในแผนที่แบบเห็นภาพ

แนวทางปฏิบัติแนะนำบางส่วนในการเตรียมข้อมูลมีดังนี้

  1. ลดพร็อพเพอร์ตี้ของฟีเจอร์ให้เหลือน้อยที่สุด เก็บเฉพาะพร็อพเพอร์ตี้ของฟีเจอร์ที่จำเป็นในการจัดรูปแบบ แผนที่ เช่น "id" และ "category" คุณสามารถรวมพร็อพเพอร์ตี้เพิ่มเติมเข้ากับฟีเจอร์ในแอปพลิเคชันไคลเอ็นต์ ได้โดยใช้การจัดรูปแบบตามข้อมูลในคีย์ตัวระบุที่ไม่ซ้ำกัน ดูตัวอย่างได้ที่ ดูข้อมูลแบบเรียลไทม์ด้วยการจัดรูปแบบตามข้อมูล.
  2. ใช้ประเภทข้อมูลอย่างง่าย สำหรับออบเจ็กต์พร็อพเพอร์ตี้ เช่น จำนวนเต็ม หากเป็นไปได้ เพื่อลดขนาดการ์ดและเพิ่มประสิทธิภาพของแผนที่
  3. ลดความซับซ้อนของรูปทรงเรขาคณิตที่ซับซ้อน ก่อนอัปโหลดไฟล์ คุณสามารถทำได้ในเครื่องมือเชิงพื้นที่ที่คุณเลือก เช่น ยูทิลิตี Mapshaper.org แบบโอเพนซอร์ส หรือใน BigQuery โดยใช้ ST_Simplify กับรูปทรงเรขาคณิตรูปหลายเหลี่ยมที่ซับซ้อน
  4. จัดกลุ่มจุดที่หนาแน่นมาก ก่อนอัปโหลดไฟล์ คุณสามารถทำได้ในเครื่องมือเชิงพื้นที่ที่คุณเลือก เช่น โอเพนซอร์ส ฟังก์ชันการจัดกลุ่ม turf.js หรือใน BigQuery โดยใช้ ST_CLUSTERDBSCAN กับรูปทรงเรขาคณิตจุดที่หนาแน่น

ดูคำแนะนำเพิ่มเติมเกี่ยวกับแนวทางปฏิบัติแนะนำสำหรับชุดข้อมูลได้ที่ แสดงข้อมูลเป็นภาพด้วยชุดข้อมูลและ BigQuery

ข้อกำหนดของ GeoJSON

Maps Datasets API รองรับข้อกำหนด GeoJSON ปัจจุบัน นอกจากนี้ Maps Datasets API ยังรองรับไฟล์ GeoJSON ที่มีออบเจ็กต์ประเภทใดประเภทหนึ่งต่อไปนี้

  • ออบเจ็กต์รูปทรงเรขาคณิต ออบเจ็กต์รูปทรงเรขาคณิตคือรูปร่างเชิงพื้นที่ ซึ่งอธิบายเป็นจุด เส้น และรูปหลายเหลี่ยมที่รวมกันโดยมีรูเป็นตัวเลือก
  • ออบเจ็กต์ฟีเจอร์ ออบเจ็กต์ฟีเจอร์มีรูปทรงเรขาคณิตและคู่ชื่อ/ค่าเพิ่มเติม ซึ่งมีความหมายเฉพาะเจาะจงกับแอปพลิเคชัน
  • คอลเล็กชันฟีเจอร์ คอลเล็กชันฟีเจอร์คือชุดออบเจ็กต์ฟีเจอร์

Maps Datasets API ไม่รองรับไฟล์ GeoJSON ที่มีข้อมูลในระบบอ้างอิงพิกัด (CRS) อื่นที่ไม่ใช่ WGS84

ดูข้อมูลเพิ่มเติมเกี่ยวกับ GeoJSON ได้ที่ RFC 7946 compliant

ข้อกำหนดของ KML

Maps Datasets API มีข้อกำหนดดังนี้

  • URL ทั้งหมดต้องเป็น URL ในเครื่อง (หรือ URL สัมพัทธ์) กับไฟล์เอง
  • รองรับรูปทรงเรขาคณิตของจุด เส้น และรูปหลายเหลี่ยม
  • แอตทริบิวต์ข้อมูลทั้งหมดจะถือว่าเป็นสตริง
ระบบไม่รองรับฟีเจอร์ KML ต่อไปนี้
  • ไอคอนหรือ <styleUrl> ที่กำหนดไว้นอกไฟล์
  • ลิงก์เครือข่าย เช่น <NetworkLink>
  • การวางซ้อนพื้น เช่น <GroundOverlay>
  • รูปทรงเรขาคณิต 3 มิติหรือแท็กที่เกี่ยวข้องกับความสูง เช่น <altitudeMode>
  • ข้อกำหนดของกล้อง เช่น <LookAt>
  • รูปแบบที่กำหนดไว้ภายในไฟล์ KML

ข้อกำหนดของ CSV

สำหรับไฟล์ CSV ชื่อคอลัมน์ที่รองรับจะแสดงอยู่ด้านล่างตามลำดับความสำคัญ

  • latitude, longitude
  • lat, long
  • x, y
  • wkt (Well-Known Text)
  • address, city, state, zip
  • address
  • คอลัมน์เดียวที่มีข้อมูลที่อยู่ทั้งหมด เช่น 1600 Amphitheatre Parkway Mountain View, CA 94043

ตัวอย่างเช่น ไฟล์มีคอลัมน์ชื่อ x, y และ wkt เนื่องจาก x และ y มีลำดับความสำคัญสูงกว่าตามลำดับชื่อคอลัมน์ที่รองรับในรายการด้านบน ระบบจึงใช้ค่าในคอลัมน์ x และ y และละเว้นคอลัมน์ wkt

นอกจากนี้

  • ชื่อคอลัมน์แต่ละชื่อต้องอยู่ในคอลัมน์เดียว นั่นคือ คุณไม่สามารถมีคอลัมน์ชื่อ xy ที่มีทั้งข้อมูลพิกัด x และ y พิกัด x และ y ต้องอยู่ใน คอลัมน์แยกกัน
  • ชื่อคอลัมน์ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
  • ลำดับของชื่อคอลัมน์ไม่มีความสำคัญ ตัวอย่างเช่น หากไฟล์ CSV มีคอลัมน์ lat และ long คอลัมน์เหล่านี้จะอยู่ในลำดับใดก็ได้

จัดการข้อผิดพลาดในการอัปโหลดข้อมูล

เมื่ออัปโหลดข้อมูลไปยังชุดข้อมูล คุณอาจพบข้อผิดพลาดที่พบบ่อยข้อใดข้อหนึ่งที่อธิบายไว้ในส่วนนี้

ข้อผิดพลาดของ GeoJSON

ข้อผิดพลาดที่พบบ่อยของ GeoJSON ได้แก่

  • ไม่มีฟิลด์ type หรือ type ไม่ใช่สตริง ไฟล์ข้อมูล GeoJSON ที่อัปโหลด ต้องมีฟิลด์สตริงชื่อ type ซึ่งเป็นส่วนหนึ่งของคำจำกัดความออบเจ็กต์ฟีเจอร์และออบเจ็กต์รูปทรงเรขาคณิตแต่ละรายการ

ข้อผิดพลาดของ KML

ข้อผิดพลาดที่พบบ่อยของ KML ได้แก่

  • ไฟล์ข้อมูลต้องไม่มีฟีเจอร์ KML ที่ไม่รองรับซึ่งระบุไว้ข้างต้น ไม่เช่นนั้นการ นำเข้าข้อมูลอาจล้มเหลว

ข้อผิดพลาดของ CSV

ข้อผิดพลาดที่พบบ่อยของ CSV ได้แก่

  • บางแถวไม่มีค่าสำหรับคอลัมน์รูปทรงเรขาคณิต ทุกแถวในไฟล์ CSV ต้องมี ค่าที่ไม่ใช่ค่าว่างสำหรับคอลัมน์รูปทรงเรขาคณิต คอลัมน์รูปทรงเรขาคณิต ได้แก่
    • latitude, longitude
    • lat, long
    • x, y
    • wkt
    • address, city, state, zip
    • address
    • คอลัมน์เดียวที่มีข้อมูลที่อยู่ทั้งหมด เช่น 1600 Amphitheatre Parkway Mountain View, CA 94043
  • หาก x และ y เป็นคอลัมน์รูปทรงเรขาคณิต โปรดตรวจสอบว่าหน่วยเป็น ลองจิจูดและละติจูด ชุดข้อมูลสาธารณะบางชุดใช้ระบบพิกัดที่แตกต่างกันภายใต้ส่วนหัว x และ y หากใช้หน่วยที่ไม่ถูกต้อง ชุดข้อมูลอาจนำเข้า ได้สำเร็จ แต่ข้อมูลที่แสดงอาจแสดงจุดของชุดข้อมูลในตำแหน่งที่ไม่คาดคิด