ดูข้อมูลเกี่ยวกับการส่งออกเป็นรูปแบบอื่นๆ รวมถึงรูปภาพ วิดีโอ และตาราง (ข้อมูลเวกเตอร์) ได้ที่การส่งออกข้อมูล
ภาพรวม
หากต้องการแสดงข้อมูลรูปภาพ (ข้อมูลแรสเตอร์) บนแผนที่ออนไลน์ คุณสามารถส่งออกไทล์แผนที่โดยใช้ Export.map.toCloudStorage() ฟังก์ชันนี้จะส่งออกพีระมิดของไทล์แผนที่ไปยังที่เก็บข้อมูล Cloud Storage ซึ่งสามารถแสดงต่อสาธารณะหรือแบบส่วนตัวได้ ซึ่งจะมีประโยชน์เมื่อข้อมูลรูปภาพมีขนาดใหญ่เกินกว่าที่จะวางซ้อนเป็นรูปภาพเดียว แผนที่ย่อยเหล่านี้ใช้พิกัดแผนที่ย่อยของ Google Maps และเหมาะสำหรับการแสดงผลโดยใช้ Google Maps Platform (Maps API), Google Earth สำหรับเว็บ และแพลตฟอร์มการทำแผนที่อื่นๆ คุณสามารถดูตัวอย่างไทล์ใน Google Maps หรือ Earth ได้ง่ายๆ โดยใช้ไฟล์ HTML ที่ให้มาเป็นส่วนหนึ่งของการส่งออก
การส่งออกมีการตั้งค่าและขั้นตอนหลายอย่าง ซึ่งอาจจำเป็นหรือไม่จำเป็นก็ได้ ทั้งนี้ขึ้นอยู่กับวิธีที่คุณวางแผนจะใช้หรือเผยแพร่ชิ้นส่วนแผนที่ แพลตฟอร์มการแมปบางแพลตฟอร์มกำหนดให้ไทล์ต้องเข้าถึงได้แบบสาธารณะ ในขณะที่บางแพลตฟอร์มจะทำงานกับไทล์ส่วนตัว หากใช้ Google Maps API อย่างใดอย่างหนึ่ง คุณอาจต้องมีคีย์ API ของ Google Maps Platform หากคุณแสดงไทล์ไปยัง Google Earth หรือแพลตฟอร์มการแมปอื่นๆ คุณอาจต้องตั้งค่าตัวเลือกระดับการเข้าถึงและการเข้าถึง JS (CORS) ที่เหมาะสม ทั้งนี้ขึ้นอยู่กับวิธีที่คุณวางแผนจะใช้ไทล์ ดูการตั้งค่าที่จำเป็นได้ในส่วนหลักเกณฑ์เฉพาะแพลตฟอร์มด้านล่าง
ส่งออกชิ้นส่วนแผนที่ไปยัง Cloud Storage
ตัวอย่างต่อไปนี้จะส่งออกชิ้นส่วนจากรูปภาพ Landsat สำหรับพื้นที่ในแคลิฟอร์เนีย
ตัวแก้ไขโค้ด (JavaScript)
// --- Example Export Map Tiles - basic --- // Specify area to clip/export, setup image and preview on map. var exportRegion = ee.Geometry.BBox(-122.9, 37.1, -121.2, 38.2); var landsatImage = ee.Image('LANDSAT/LC09/C02/T1_TOA/LC09_044034_20220111') .select(['B4', 'B3', 'B2']) .visualize({min: 0.02, max: 0.4, gamma: 1.2}) .clip(exportRegion); Map.addLayer(landsatImage, {}, 'landsatImage'); Map.centerObject(exportRegion); // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForEE', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true });
import ee import geemap.core as geemap
Colab (Python)
# --- Example Export Map Tiles - basic --- # Specify area to clip/export, setup image and preview on map. export_region = ee.Geometry.BBox(-122.9, 37.1, -121.2, 38.2) landsat_image = ( ee.Image('LANDSAT/LC09/C02/T1_TOA/LC09_044034_20220111') .select(['B4', 'B3', 'B2']) .visualize(min=0.02, max=0.4, gamma=1.2) .clip(export_region) ) m = geemap.Map() m.add_layer(landsat_image, {}, 'landsatImage') m.center_object(export_region) display(m) # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForEE', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, ) task.start()
โปรดทราบว่าการดำเนินการนี้จะสร้างไดเรกทอรีใหม่ในที่เก็บข้อมูล Cloud Storage ที่ระบุ ซึ่งตั้งชื่อตามพารามิเตอร์ description โดยค่าเริ่มต้น คุณเปลี่ยนชื่อไดเรกทอรีหรือระบุไดเรกทอรีย่อยได้ด้วยพารามิเตอร์ path คุณสามารถใช้ไฟล์ index.html และ earth.html ในไดเรกทอรีเอาต์พุตเพื่อดูตัวอย่างการ์ดใน Maps หรือ Earth ได้
ตัวเลือก ACL และ CORS
ตัวอย่างด้านบนตั้งค่า ACL (รายการควบคุมการเข้าถึง) ของชิ้นส่วนแผนที่เพื่อให้เข้าถึงแบบสาธารณะผ่านคำขอโดยตรงได้ แต่ไม่ได้ตั้งค่าการเข้าถึง JS ของที่เก็บข้อมูล (การตั้งค่า CORS) เพื่ออนุญาตให้เว็บแอปเข้าถึงชิ้นส่วนแผนที่ได้
ซึ่งหมายความว่าคุณจะดูชิ้นส่วนที่ส่งออกเหล่านี้ได้ในตัวอย่าง Maps และ Earth แต่จะไม่มีประโยชน์สำหรับแพลตฟอร์มอื่นๆ ที่ต้องใช้การเข้าถึง JS ระบบจะถือว่าคุณเป็นเจ้าของที่เก็บข้อมูลเอาต์พุต
หากคุณเป็นผู้เขียนในที่เก็บข้อมูลเอาต์พุตที่ระบุ (แต่ไม่ใช่เจ้าของ) ให้ตั้งค่า writePublicTiles เป็น false เพื่อใช้ ACL ของออบเจ็กต์เริ่มต้นของที่เก็บข้อมูลเอาต์พุต
หากต้องการเปิดไทล์ให้เว็บแอปทั้งหมดเข้าถึงแบบสาธารณะ ให้เพิ่ม bucketCorsUris: ['*'] ลงในพารามิเตอร์งาน โปรดทราบว่าการเข้าถึง JS สาธารณะแบบเต็มอาจไม่เป็นที่พึงประสงค์เมื่อมีความเสี่ยงที่บุคคลที่สามจะใช้การ์ดของคุณและทำให้เกิดค่าใช้จ่ายในระบบคลาวด์ หากต้องการจำกัดการเข้าถึงนี้ คุณสามารถจำกัดการเข้าถึง JS ให้เฉพาะเว็บแอปในโดเมนหรือ URL ที่เจาะจงได้ โปรดทราบว่าการตั้งค่าการเข้าถึง JS (CORS) จะมีผลที่ระดับทั้งที่เก็บข้อมูล ไม่ใช่ที่ระดับโฟลเดอร์หรือออบเจ็กต์
คุณตั้งค่า ACL และ CORS ได้โดยใช้พารามิเตอร์ writePublicTiles และ bucketCorsUris ตามลำดับ หรือจากกล่องโต้ตอบงานส่งออกดังที่แสดงด้านล่าง
Export.map.toCloudStorage()
- สิทธิ์ดู/ดาวน์โหลด หากต้องการเข้าถึงเลย (เช่น จากตัวแก้ไขโค้ดหรือแอป Earth Engine) คุณจะต้องทำให้ไทล์ "เข้าถึงได้แบบสาธารณะ"
- สิทธิ์เข้าถึง JS ที่เก็บข้อมูลที่ส่งออกแผนที่ต้องอนุญาตให้อ่านได้หากคุณต้องการให้ตัวแก้ไขโค้ด, แอป Earth Engine หรือเว็บแอปอื่นๆ เข้าถึงการ์ดได้ ต้องกำหนดค่าการตั้งค่าคำขอข้ามต้นทาง (CORS) เหล่านี้ที่ระดับที่เก็บข้อมูล กล่องโต้ตอบการส่งออกของ Earth Engine ช่วยให้คุณกำหนดค่า CORS สำหรับที่เก็บข้อมูลได้ในขณะส่งออกเพื่อความสะดวก
- หมายเหตุ: การตั้งค่าการเข้าถึง JS/CORS จะมีผลที่ระดับที่เก็บข้อมูล ไม่ใช่ที่ระดับโฟลเดอร์หรือออบเจ็กต์ ดังนั้นการเปลี่ยนการตั้งค่าจะอัปเดตการตั้งค่าสำหรับโฟลเดอร์และออบเจ็กต์ทั้งหมดในที่เก็บข้อมูล ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบเกี่ยวกับ CORS ของ Cloud Storage รวมถึงวิธีดูการกำหนดค่า CORS ปัจจุบันสำหรับที่เก็บข้อมูล
รายการพารามิเตอร์
ด้านล่างนี้คือรายการพารามิเตอร์ทั้งหมดสำหรับงานส่งออกชิ้นส่วนแผนที่ ซึ่งแสดงชื่อพารามิเตอร์ (อาร์กิวเมนต์) ในโค้ด และฟิลด์ที่เกี่ยวข้องในกล่องโต้ตอบงาน (หากมี) โปรดทราบว่าบางช่องจะแยกกันโดยสิ้นเชิง (เช่น maxzoom และ scale) ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบ Export.map
| อาร์กิวเมนต์ในโค้ด | ช่องในกล่องโต้ตอบงาน | หมายเหตุ |
|---|---|---|
| รูปภาพ | ไม่มี | รูปภาพที่จะส่งออกเป็นชิ้นส่วน ต้องเป็นรูปภาพ ไม่ใช่ ImageCollection |
| คำอธิบาย | ชื่องาน | ชื่องานที่มนุษย์อ่านได้ ค่าเริ่มต้นคือ "myExportMapTask" นอกจากนี้ยังใช้เป็นชื่อโฟลเดอร์สำหรับไทล์ด้วย หากไม่ได้ระบุพารามิเตอร์ "path" (คำนำหน้าเอาต์พุต) |
| ที่เก็บข้อมูล | ชื่อ Bucket ของ GCS | บักเก็ตปลายทางที่จะเขียนข้อมูลลงไป |
| fileFormat | รูปแบบไฟล์ | รูปแบบไฟล์ของชิ้นส่วนแผนที่ ซึ่งเป็น "auto", "png" หรือ "jpg" อย่างใดอย่างหนึ่ง ค่าเริ่มต้นคือ "auto" ซึ่งหมายความว่าไทล์ทึบแสงจะได้รับการเข้ารหัสเป็น "jpg" และไทล์ที่มีความโปร่งใสจะได้รับการเข้ารหัสเป็น "png" |
| เส้นทาง | คำต่อท้ายเอาต์พุต | สตริงที่ใช้เป็นเส้นทางของเอาต์พุต คุณจะใส่ "/" ต่อท้ายหรือไม่ก็ได้ ค่าเริ่มต้นคือคำอธิบายของงาน (ชื่องาน) |
| writePublicTiles | ระดับการเข้าถึงเพื่อดู/ดาวน์โหลด | เลือกว่าจะเขียนไทล์สาธารณะแทนการใช้ ACL ของออบเจ็กต์เริ่มต้นของที่เก็บข้อมูลหรือไม่ ค่าเริ่มต้นคือ "จริง" และผู้เรียกใช้เป็นเจ้าของที่เก็บข้อมูล |
| maxZoom | ความละเอียดสูงสุดและการซูมสูงสุด | ระดับการซูมสูงสุดของไทล์แผนที่ที่จะส่งออก |
| ปรับขนาด | ความละเอียดสูงสุดและขนาดสูงสุด | ความละเอียดสูงสุดของรูปภาพในหน่วยเมตรต่อพิกเซล ซึ่งเป็นทางเลือกแทน "maxZoom" มาตราส่วนจะถูกแปลงเป็นระดับการซูมสูงสุดที่เหมาะสมที่สุดที่เส้นศูนย์สูตร |
| minZoom | ความละเอียดสูงสุดและการซูมต่ำสุด | ระดับการซูมขั้นต่ำ (ไม่บังคับ) ของไทล์แผนที่ที่จะส่งออก ค่าเริ่มต้นคือ 0 |
| ภูมิภาค | ไม่มี | LinearRing, Polygon หรือพิกัดที่แสดงถึงภูมิภาคที่จะส่งออก ดูรายละเอียดได้ในเอกสารประกอบ |
| skipEmptyTiles | ไม่มี | หากเป็นจริง ให้ข้ามการเขียนไทล์แผนที่ที่ว่างเปล่า (เช่น โปร่งใสทั้งหมด) ค่าเริ่มต้นคือ "เท็จ" |
| mapsApiKey | คีย์ Maps API | ใช้ใน index.html เพื่อเริ่มต้น Google Maps API ซึ่งจะนำข้อความ "เพื่อวัตถุประสงค์ในการพัฒนาเท่านั้น" ออกจากแผนที่ |
| bucketCorsUris | เพิ่มการเข้าถึง JS (และเว็บไซต์ที่จะอนุญาต) | รายการโดเมน (เช่น https://code.earthengine.google.com) ที่ได้รับอนุญาตให้ดึงข้อมูลชิ้นส่วนแผนที่ที่ส่งออกผ่าน JavaScript (CORS) |
ปรับขนาดและซูม
ในตัวอย่างก่อนหน้านี้ maxZoom ตั้งค่าเป็น 13
ระดับการซูมจะสอดคล้องกับตารางกริดพิกเซลขนาดต่างๆ ที่ใช้แสดงแผนที่โลก (ดูรายละเอียดได้ที่ข้อมูลอ้างอิงพิกัดพิกเซล) เนื่องจากความโค้งของโลก ความละเอียดของพิกเซลที่ระดับการซูมหนึ่งๆ จึงแตกต่างกันไปตามละติจูด โดยเฉพาะอย่างยิ่ง เมตรต่อพิกเซลจะลดลงตามปัจจัยของ cos(latitude) ตารางต่อไปนี้แสดงจำนวนเมตรต่อพิกเซลที่ระดับการซูมแต่ละระดับที่เส้นศูนย์สูตรสำหรับการฉายภาพ Google Mercator
| ระดับการซูม | ขนาดพิกเซล (ที่เส้นศูนย์สูตร) | ระดับการซูม | ขนาดพิกเซล (ที่เส้นศูนย์สูตร) |
|---|---|---|---|
| 0 | 156 กม. | 10 | 152 ม. |
| 1 | 78 กม. | 11 | 76 ม. |
| 2 | 39 กม. | 12 | 38 ม. |
| 3 | 20 กม. | 13 | 19 ม. |
| 4 | 10 กม. | 14 | 9.6 ม. |
| 5 | 4.9 กม. | 15 | 4.8 ม. |
| 6 | 2.4 กม. | 16 | 2.4 ม. |
| 7 | 1.2 กม. | 17 | 1.2 ม. |
| 8 | 611 ม. | 18 | 0.6 ม. |
| 9 | 305 ม. | 19 | 0.3 ม. |
| 20 | 0.15 ม. |
สังเกตจากตารางก่อนหน้าว่า maxZoom ที่ตั้งค่าในตัวอย่างสอดคล้องกับ 19 เมตรที่เส้นศูนย์สูตร และมีขนาดเล็กลงที่ละติจูดที่สูงขึ้น ซึ่งน้อยกว่าความละเอียด 30 อาร์ควินาทีต่อพิกเซลที่ระบุของรูปภาพอินพุต ด้วยเหตุนี้ แผนที่ที่แสดงในเอาต์พุต
index.html
จึงซูมเข้าได้จนกว่าจะเห็นพิกเซลในความละเอียดแบบเนทีฟในแผนที่
หากต้องการจำกัดการแสดงแผนที่ให้เป็นความละเอียดพิกเซลแบบเนทีฟ ให้ตั้งค่า maxZoom เป็นค่าที่สอดคล้องกับความละเอียดแบบเนทีฟหรือต่ำกว่า
หลักเกณฑ์เฉพาะแพลตฟอร์ม
ด้านล่างนี้คือแพลตฟอร์มจำนวนหนึ่งที่คุณอาจต้องการดูและใช้การ์ดแผนที่ แต่ละส่วนจะระบุการตั้งค่าที่จำเป็นสำหรับไทล์เพื่อทำงานร่วมกับแพลตฟอร์มนั้น และสำเนาโค้ดตัวอย่างพร้อมพารามิเตอร์ที่จำเป็น
ใช้ชิ้นส่วนแผนที่ใน Earth Engine (ตัวแก้ไขโค้ดหรือแอป EE)
หากต้องการส่งออกชิ้นส่วนแผนที่เพื่อนำมาใช้ซ้ำใน Google Earth Engine หรือแอป EE เท่านั้น ให้ตั้งค่า "ระดับการเข้าถึง" เป็น "เข้าถึงได้แบบสาธารณะ" และตั้งค่า "ระดับการเข้าถึง JS" (ในกล่องโต้ตอบงาน) เป็น "เพิ่มสิทธิ์เข้าถึง Earth Engine" หรือ "เพิ่มสิทธิ์เข้าถึงแบบสาธารณะ" หรือจะตั้งค่าพารามิเตอร์เหล่านี้ในโค้ดก็ได้ ดังนี้
writePublicTiles: true, bucketCorsUris: ['https://code.earthengine.google.com','https://*.earthengine.app']
เมื่อส่งออกชิ้นส่วนแล้ว คุณจะเข้าถึงชิ้นส่วนเหล่านั้นได้ใน Earth Engine
ตัวแก้ไขโค้ด (JavaScript)
// --- Export Map Tiles for use in EE --- // Use image setup code from example at top of the page. // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForEE', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true, bucketCorsUris: ['https://code.earthengine.google.com','https://*.earthengine.app'] });
import ee import geemap.core as geemap
Colab (Python)
# --- Export Map Tiles for use in EE --- # Use image setup code from example at top of the page. # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForEE', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, bucketCorsUris=[ 'https://code.earthengine.google.com', 'https://*.earthengine.app', ], ) task.start()
ดูตัวอย่าง Google Maps
หากต้องการดูตัวอย่างชิ้นส่วนแผนที่ใน Google Maps ให้ไปที่โฟลเดอร์เอาต์พุตใน Google Cloud Storage แล้วเปิดไฟล์ "index.html" ในเบราว์เซอร์ ซึ่งจะเปิดแผนที่แบบเต็มหน้าซึ่งแสดงไทล์ของคุณใน Google Maps โดยใช้ Javascript API ของ Google Maps Platform ดังนี้ index.html การส่งออกขั้นพื้นฐานจะส่งผลให้ไทล์แผนที่ฐานเป็นสีเทาและมีลายน้ำ "เพื่อวัตถุประสงค์ในการพัฒนาเท่านั้น" เพื่อหลีกเลี่ยงปัญหานี้และแสดงไทล์แผนที่ฐานมาตรฐานของ Google ให้สร้างคีย์ API และรวมไว้ในการตั้งค่าการส่งออก
หากคุณระบุคีย์ API ในขณะส่งออก หน้าตัวอย่างนี้จะแสดงต่อสาธารณะ ฝังในหน้าอื่นๆ ได้ และไม่กำหนดให้ผู้ดูต้องเป็นผู้ใช้ Earth Engine ที่ลงทะเบียน
ตัวแก้ไขโค้ด (JavaScript)
// --- Export Map Tiles for use with Map Preview --- // Use image setup code from example at top of the page. // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForMapPreview', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true, mapsApiKey: 'fakeMapsApiKey012345' // replace with a valid API Key });
import ee import geemap.core as geemap
Colab (Python)
# --- Export Map Tiles for use with Map Preview --- # Use image setup code from example at top of the page. # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForMapPreview', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, mapsApiKey='fakeMapsApiKey012345', # replace with a valid API Key ) task.start()
ดูตัวอย่าง Google Earth
หากต้องการดูตัวอย่างไทล์แผนที่ใน Google Earth บนเว็บ ให้ตรวจสอบว่าคุณส่งออกไทล์โดยตั้งค่าระดับการเข้าถึงเป็น "เข้าถึงได้แบบสาธารณะ" จากนั้นไปที่โฟลเดอร์เอาต์พุตใน Google Cloud Storage แล้วเปิดไฟล์ "earth.html" ในเบราว์เซอร์ เช่นไฟล์นี้ earth.html แล้วคลิกปุ่ม "เปิดใน Google Earth" ที่ปรากฏขึ้น ซึ่งจะเปิด Google Earth และแสดงไทล์บนแผนที่ 3 มิติ แนวทางปฏิบัติแนะนำคือให้ตั้งค่าระดับ "การเข้าถึง JS" เป็น "เข้าถึงได้แบบสาธารณะ" ด้วย ซึ่งจะช่วยให้คุณใช้การ์ดใน Google Earth ได้โดยไม่ต้องมีไฟล์ตัวอย่าง (ซึ่งใช้พร็อกซีเซิร์ฟเวอร์หากการ์ดไม่มีการตั้งค่าการเข้าถึง JS/CORS ที่จำเป็น)
หากต้องการดาวน์โหลดไฟล์ KML ที่มีลิงก์ไปยังข้อมูลของคุณ ให้คลิกเมนู 3 จุดใน Google Earth แล้วเลือก "ส่งออกเป็นไฟล์ KML" หมายเหตุ: ไฟล์ KML ที่สร้างขึ้นในลักษณะนี้จะใช้กับ Google Earth Pro (Earth เวอร์ชันเดสก์ท็อป) ไม่ได้
ตัวแก้ไขโค้ด (JavaScript)
// --- Export Map Tiles for use with Earth Preview --- // Use image setup code from example at top of the page. // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForEarthPreview', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true, bucketCorsUris: [] // leaving blank is ok for Earth Preview only // for direct use in Earth, set to: ['https://earth.google.com'] // or set to public: ['*'] (risk of misuse) });
import ee import geemap.core as geemap
Colab (Python)
# --- Export Map Tiles for use with Earth Preview --- # Use image setup code from example at top of the page. # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForEarthPreview', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, bucketCorsUris=[], # leaving blank is ok for Earth Preview only # for direct use in Earth, set to: ['https://earth.google.com'] # or set to public: ['*'] (risk of misuse) ) task.start()
เผยแพร่ด้วย Google Maps Platform (Maps API)
หากต้องการสร้างชุดชิ้นส่วนแผนที่ที่พร้อมเผยแพร่ต่อสาธารณะผ่าน Google Maps Platform คุณจะต้องมีหรือสร้างคีย์ API และตรวจสอบว่าได้ตั้งค่าระดับการเข้าถึงเป็น "เข้าถึงได้แบบสาธารณะ" คุณอาจต้องตั้งค่า "ระดับการเข้าถึง JS" ที่เหมาะสมสำหรับเว็บไซต์ด้วย ทั้งนี้ขึ้นอยู่กับวิธีที่แอปพลิเคชัน Maps API เข้าถึงการ์ด เมื่อส่งออกไทล์แล้ว เอาต์พุตในแท็บงานของตัวแก้ไขโค้ดจะแสดง URL สำหรับไทล์พร้อมตัวแปรที่เหมาะสมสำหรับใช้กับ Google Maps API เช่น
https://storage.googleapis.com/my_bucket/my_test_tiles/{Z}/{X}/{Y}
ตัวแก้ไขโค้ด (JavaScript)
// --- Export Map Tiles for use with Maps Platform APIs --- // Use image setup code from example at top of the page. // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForMapsPlatform', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true, bucketCorsUris: ['*'], // '*' = All domains = risk of misuse // For better protection, specify the domain(s) where the // tiles will be used, eg: ['https://mysite.mydomain.com'] mapsApiKey: 'fakeMapsApiKey012345' // replace with a valid API Key });
import ee import geemap.core as geemap
Colab (Python)
# --- Export Map Tiles for use with Maps Platform APIs --- # Use image setup code from example at top of the page. # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForMapsPlatform', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, bucketCorsUris=['*'], # '*' = All domains = risk of misuse # For better protection, specify the domain(s) where the # tiles will be used, eg: ['https://mysite.mydomain.com'] mapsApiKey='fakeMapsApiKey012345', # replace with a valid API Key ) task.start()
เผยแพร่ไปยัง Google Earth (บนเว็บ)
หากต้องการสร้างชุดชิ้นส่วนแผนที่เพื่อเผยแพร่ต่อสาธารณะผ่าน Google Earth คุณจะต้องตั้งค่าระดับการเข้าถึงเป็น "เข้าถึงได้แบบสาธารณะ" และตั้งค่าระดับการเข้าถึง JS เพื่ออนุญาต "https://earth.google.com" (หรือ "เข้าถึงได้แบบสาธารณะ") หลังจากส่งออกแล้ว คุณจะดูตัวอย่างใน Google Earth ได้โดยใช้ไฟล์ earth.html ในไดเรกทอรีการส่งออก (ดูด้านบน)
ตัวแก้ไขโค้ด (JavaScript)
// --- Export Map Tiles for use with Google Earth web --- // Use image setup code from example at top of the page. // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForEarthWeb', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true, bucketCorsUris: ['https://earth.google.com'] // ['*'] will also work, but risks misuse });
import ee import geemap.core as geemap
Colab (Python)
# --- Export Map Tiles for use with Google Earth web --- # Use image setup code from example at top of the page. # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForEarthWeb', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, bucketCorsUris=['https://earth.google.com'], # ['*'] will also work, but risks misuse ) task.start()
เมื่อส่งออกไทล์แล้ว คุณจะเพิ่มไทล์ลงในโปรเจ็กต์ใน Google Earth บนเว็บได้ เอาต์พุตในแท็บ Tasks ของตัวแก้ไขโค้ด (แสดงด้านล่าง) จะแสดง URL สำหรับไทล์พร้อมตัวแปรที่เหมาะสมสำหรับใช้ใน Google Earth เช่น
https://storage.googleapis.com/my_bucket/my_test_tiles/$[level]/$[x]/$[y]
หากต้องการใช้ฟีเจอร์นี้ใน Earth เวอร์ชันเว็บ ให้สร้างฟีเจอร์การวางซ้อนไทล์ แล้วเพิ่ม URL นี้เป็น "URL การวางซ้อน" หากชุดข้อมูลของคุณไม่ใช่แบบทั่วโลกและคุณต้องการหลีกเลี่ยงข้อผิดพลาดคำขอไทล์สำหรับไทล์ที่ไม่มีอยู่ ให้เปิดส่วน "ตัวเลือกการวางซ้อน" และปรับพารามิเตอร์การครอบคลุมไทล์ 4 รายการให้ตรงกับขอบเขตของไทล์ที่ส่งออก
เผยแพร่ไปยังแพลตฟอร์มการแมปอื่นๆ
เมื่อส่งออกการ์ดเพื่อใช้กับแพลตฟอร์มหรือแอปพลิเคชันอื่นๆ การตั้งค่าที่จำเป็นจะขึ้นอยู่กับวิธีที่แพลตฟอร์มหรือแอปพลิเคชันเหล่านั้นเข้าถึงการ์ด หากต้องการให้ไทล์เข้าถึงได้ในวงกว้างที่สุด ให้ตั้งค่าระดับการเข้าถึงเป็น "เข้าถึงได้แบบสาธารณะ" และตั้งค่าระดับการเข้าถึง JS เป็น "เข้าถึงได้แบบสาธารณะ"
สร้างคีย์ API ของ Google Maps Platform
หากวางแผนที่จะใช้ Map Tiles กับ Google Maps Platform หรือต้องการแสดงตัวอย่างใน Maps โดยไม่มีแผนที่ฐานที่ถูกจำกัดสำหรับนักพัฒนาแอป คุณจะต้องมีหรือสร้างคีย์ API ของ Google Maps Platform และรวมไว้ในการตั้งค่าการส่งออก หรือเพิ่มลงในเว็บไซต์ในภายหลัง ซึ่งไม่จำเป็นสำหรับการใช้งานกับ Google Earth
เมื่อคุณส่งออกชิ้นส่วนแผนที่จาก Earth Engine เราจะสร้างหน้า HTML ตัวอย่างที่จัดเก็บไว้ในไดเรกทอรีเอาต์พุตเพื่อให้คุณดูตัวอย่างชิ้นส่วนแผนที่โดยใช้ JavaScript API ของ Google Maps Platform คุณสามารถระบุคีย์ API ของ Google Maps Platform ได้เมื่อส่งออก ซึ่งจะใช้สำหรับการเรียก API ของโปรแกรมดูตัวอย่าง
หากต้องการสร้างคีย์ API ของ Google Maps Platform ตอนนี้ ให้ทำตาม 4 ขั้นตอนต่อไปนี้
- คลิกปุ่ม "สร้างคีย์ API ของ Google Maps Platform" ด้านล่าง
- เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์สำหรับคีย์ API แล้วคลิก "ถัดไป"
- คลิก เพื่อคัดลอกคีย์ใหม่ แล้ววางลงในกล่องโต้ตอบ Export map ในตัวแก้ไขโค้ด
- (แนะนำ) คลิกลิงก์คอนโซล API ใต้คีย์ใหม่เพื่อตั้งค่าข้อจำกัดของ URL ที่มา ดูรายละเอียดเพิ่มเติมได้ที่ข้อจำกัดเกี่ยวกับ URL ที่มาและแอปพลิเคชัน
สร้างคีย์ API ของ Maps Platform
เพิ่มข้อจำกัดเกี่ยวกับ URL ที่มาให้กับคีย์ API
เมื่อเพิ่มคีย์ API การจำกัด URL ที่มาจะช่วยให้มั่นใจได้ว่ามีเพียงแอปที่กำหนดเท่านั้นที่ใช้คีย์ของคุณได้ คุณตั้งค่าหรือแก้ไขข้อจำกัดของ URL ที่มาได้ทุกเมื่อโดยไปที่หน้าข้อมูลเข้าสู่ระบบใน Cloud Console แล้วทำตามขั้นตอนต่อไปนี้
- ตรวจสอบว่าได้เลือกชื่อโปรเจ็กต์ที่ถูกต้องในเมนูแบบเลื่อนลงที่ด้านบนของหน้าจอ
- คลิกคีย์ API ของ Maps Platform ที่สร้างขึ้นด้านบนเพื่อดูรายละเอียดของคีย์
-
เลือก HTTP referrers (websites) และระบุที่เก็บข้อมูล Cloud Storage ที่ระบุใน
Export.map.toCloudStorageโดยใช้เทมเพลตต่อไปนี้https://storage.googleapis.com/{bucket}/* - คลิกบันทึก ตัวบ่งชี้ "กำลังบันทึก..." ควรปรากฏขึ้น