ชุดข้อมูลช่วยให้คุณอัปโหลดข้อมูลเชิงพื้นที่จากไฟล์ในเครื่องหรือจาก Google Cloud Storage ไปยัง Google Maps Platform ได้ จากนั้นคุณจะเชื่อมโยงชุดข้อมูลกับรูปแบบแผนที่อย่างน้อย 1 รายการใน Cloud Console ได้ หลังจากเชื่อมโยงชุดข้อมูลกับรูปแบบแผนที่แล้ว ให้ใช้ API การจัดรูปแบบที่มาจากข้อมูลเพื่อจัดรูปแบบแอปพลิเคชันแผนที่แบบไดนามิก
นอกจากนี้คุณยังใช้ API ของ REST เพื่ออัปโหลดข้อมูลเชิงพื้นที่ไปยังชุดข้อมูลได้อีกด้วย ดูข้อมูลเพิ่มเติมได้ที่ Maps Datasets API
กำหนดค่าบทบาท
หากต้องการสร้างและจัดการชุดข้อมูลในโปรเจ็กต์ Google Cloud คุณต้องมีบทบาท IAM ของเจ้าของหรือผู้แก้ไขในโปรเจ็กต์
หรือจะมอบหมายบทบาท IAM ต่อไปนี้ให้กับบัญชีผู้ใช้หรือบัญชีบริการที่คุณใช้จัดการชุดข้อมูลก็ได้
- บทบาท
Maps Platform Datasets Admin
จะมอบสิทธิ์การอ่าน/เขียนชุดข้อมูลในโปรเจ็กต์แก่ผู้ใช้หรือบัญชีบริการ บทบาทนี้ให้ผู้ใช้ดำเนินการทั้งหมดในชุดข้อมูลได้ - บทบาท
Maps Platform Datasets Viewer
จะให้สิทธิ์การอ่านอย่างเดียวแก่ชุดข้อมูลในโปรเจ็กต์ บทบาทนี้ให้คุณดำเนินการแสดงรายการ รับ หรือดาวน์โหลดบนชุดข้อมูลได้
ดูข้อมูลเพิ่มเติมได้ที่มอบบทบาท IAM โดยใช้คอนโซล Google Cloud
แหล่งข้อมูลของชุดข้อมูล
หลังจากที่คุณสร้างชุดข้อมูล ให้อัปโหลดข้อมูลไปยังชุดข้อมูลจาก Google Cloud Storage หรือจากไฟล์ในเครื่องเมื่ออัปโหลดข้อมูลจาก Cloud Storage ให้ระบุเส้นทางไฟล์ไปยังทรัพยากรที่มีข้อมูลใน Cloud Storage เส้นทางนี้อยู่ในรูปแบบ
gs://GCS_BUCKET/FILE
ผู้ใช้ที่ส่งคำขอต้องมีบทบาทผู้ดูออบเจ็กต์พื้นที่เก็บข้อมูล หรือบทบาทอื่นๆ ที่มีสิทธิ์
storage.objects.get
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการสิทธิ์เข้าถึง Cloud Storage ได้ที่ภาพรวมการควบคุมการเข้าถึง- เมื่ออัปโหลดข้อมูลจากไฟล์ในเครื่อง ให้ระบุเส้นทางไปยังไฟล์ GeoJSON, KML หรือ CSV ที่มีข้อมูลที่ต้องการอัปโหลด
ข้อกำหนดเบื้องต้น
เมื่อสร้างชุดข้อมูล:
- ชื่อที่แสดงต้องไม่ซ้ำกันภายในโปรเจ็กต์ Google Cloud
- ชื่อที่แสดงต้องมีขนาดไม่เกิน 64 ไบต์ (เนื่องจากอักขระเหล่านี้แสดงในรูปแบบ UTF-8 บางภาษาอาจแสดงอักขระหลายไบต์ได้ในบางภาษา)
- คำอธิบายต้องน้อยกว่า 1000 ไบต์
เมื่ออัปโหลดข้อมูล
- ประเภทไฟล์ที่รองรับ ได้แก่ CSV, GeoJSON และ KML
- ขนาดไฟล์สูงสุดที่รองรับคือ 350 MB
- ชื่อคอลัมน์แอตทริบิวต์ต้องไม่ขึ้นต้นด้วยสตริง "?_"
- ไม่สนับสนุนรูปทรงเรขาคณิตสามมิติ ซึ่งรวมถึงคำต่อท้าย "Z" ในรูปแบบ WKT และพิกัดระดับความสูงในรูปแบบ GeoJSON
ข้อกำหนด GeoJSON
Maps JavaScript API รองรับข้อกำหนด GeoJSON ปัจจุบัน Maps JavaScript API ยังรองรับไฟล์ GeoJSON ที่มีประเภทออบเจ็กต์ต่อไปนี้ด้วย
- วัตถุเรขาคณิต วัตถุเรขาคณิตเป็นรูปทรงเชิงพื้นที่ที่อธิบายเป็นการรวมจุด เส้น และรูปหลายเหลี่ยมที่มีช่องที่ไม่บังคับ
- วัตถุฟีเจอร์ วัตถุฟีเจอร์มีเรขาคณิตและคู่ชื่อ/ค่าเพิ่มเติม ซึ่งความหมายขึ้นอยู่กับแอปพลิเคชัน
- คอลเล็กชันฟีเจอร์ คอลเล็กชันฟีเจอร์คือชุดของออบเจ็กต์ฟีเจอร์
Maps JavaScript API ไม่รองรับไฟล์ GeoJSON ที่มีข้อมูลในระบบอ้างอิงพิกัด (CRS) ที่ไม่ใช่ WGS84
ดูข้อมูลเพิ่มเติมเกี่ยวกับ GeoJSON ได้ที่เป็นไปตามข้อกำหนด RFC 7946
ข้อกำหนดของ KML
Maps JavaScript API มีข้อกำหนดต่อไปนี้
- URL ทั้งหมดต้องอยู่ในเครื่อง (หรือเกี่ยวข้อง) กับตัวไฟล์เอง
- รองรับเรขาคณิตของจุด เส้น และรูปหลายเหลี่ยม
- แอตทริบิวต์ข้อมูลทั้งหมดจะถือว่าเป็นสตริง
- ไอคอนหรือ
<styleUrl>
ที่กำหนดไว้นอกไฟล์ - ลิงก์เครือข่าย เช่น
<NetworkLink>
- การวางซ้อนพื้นที่ เช่น
<GroundOverlay>
- เรขาคณิต 3 มิติหรือแท็กที่เกี่ยวข้องกับระดับความสูง เช่น
<altitudeMode>
- ข้อมูลจำเพาะของกล้อง เช่น
<LookAt>
- รูปแบบที่กำหนดไว้ในไฟล์ KML
ข้อกำหนดของ CSV
สำหรับไฟล์ CSV ชื่อคอลัมน์ที่รองรับจะแสดงตามลำดับความสำคัญดังนี้
latitude
longitude
lat
long
x
y
wkt
(ข้อความที่รู้จักกันดี)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
หากใช้หน่วยที่ไม่ถูกต้อง ชุดข้อมูลอาจนำเข้าได้สำเร็จ แต่ข้อมูลที่แสดงผลสามารถแสดงจุดของชุดข้อมูลในตำแหน่งที่ไม่คาดคิด
สร้างชุดข้อมูล
วิธีสร้างชุดข้อมูล
- ใน Google Cloud Console ให้ไปที่หน้าชุดข้อมูล
- คลิกสร้างชุดข้อมูล
- ป้อนชื่อชุดข้อมูล ชื่อในชุดข้อมูลทั้งหมดต้องไม่ซ้ำกัน
- ป้อนชุดข้อมูล Description (คำอธิบาย) หรือไม่ก็ได้
- คลิกต่อไป หน้านำเข้าข้อมูลจะปรากฏขึ้น
- เลือกแหล่งที่มาการอัปโหลดของข้อมูลที่ใช้เพื่อสร้างชุดข้อมูลเป็นเดสก์ท็อป ซึ่งหมายถึงไฟล์ในเครื่องในระบบของคุณ หรือที่เก็บข้อมูล Google Cloud Storage
- สำหรับเดสก์ท็อป ให้คลิกเรียกดู แล้วเลือกไฟล์จากตัวเลือกไฟล์
- สำหรับที่เก็บข้อมูล Google Cloud Storage ให้คลิกเรียกดู แล้วเลือกที่เก็บข้อมูลและไฟล์ที่มีข้อมูล
- เลือกรูปแบบไฟล์
- คลิกต่อไปเพื่อตรวจสอบการตั้งค่า
- คลิกสร้าง หน้าชุดข้อมูลจะปรากฏโดยแสดงชุดข้อมูลใหม่ของคุณ สถานะควรเป็นกำลังดำเนินการ
- รอจนกว่าชุดข้อมูลจะมีสถานะเสร็จสมบูรณ์
ดูหรือแก้ไขชุดข้อมูล
หลังจากสร้างชุดข้อมูลเรียบร้อยแล้ว สถานะชุดข้อมูลจะแสดงเป็นเสร็จสมบูรณ์ จากนั้นคุณจะตรวจสอบรายละเอียดของชุดข้อมูลได้
วิธีดูชุดข้อมูล
- ใน Google Cloud Console ให้ไปที่หน้าชุดข้อมูล
- คลิกชื่อชุดข้อมูล หน้ารายละเอียดชุดข้อมูลจะปรากฏขึ้น
- คลิกแท็บรายละเอียดเพื่อดูข้อมูลเกี่ยวกับชุดข้อมูล คุณยังแก้ไขชื่อและคำอธิบายชุดข้อมูลในแท็บนี้ได้
- คลิกแท็บแสดงตัวอย่างเพื่อดูชุดข้อมูลบนแผนที่
- คลิกแท็บข้อมูลตารางเพื่อดูข้อมูลชุดย่อยที่เชื่อมโยงกับชุดข้อมูล
- คลิกปุ่มดาวน์โหลดเพื่อดาวน์โหลดข้อมูลไปยังไฟล์ในเครื่อง
- คลิกปุ่มลบเพื่อลบชุดข้อมูล