Google Earth Engine'e (EE) resim yüklerken Kod Düzenleyici kullanıcı arayüzü veya "earthengine" komut satırı aracının upload komutunun sağladığından daha fazla esnekliğe ihtiyacınız varsa "manifest" olarak bilinen bir JSON dosyası kullanarak resim yükleme işlemini tanımlayabilir ve komut satırı aracının upload image --manifest komutunu kullanabilirsiniz.
Manifest kullanarak resim parçalarını tek bir öğe olarak yüklemeyi gösteren eksiksiz bir örneği bu Colab not defterinde bulabilirsiniz.
Tek seferlik kurulum
- Manifest yüklemeleri yalnızca Google Cloud Storage'da bulunan dosyalarla çalışır. Google Cloud Storage'ı kullanmaya başlamak için henüz yapmadıysanız bir Google Cloud projesi oluşturun. Kurulum için faturalandırma amacıyla bir kredi kartı belirtmeniz gerektiğini unutmayın. EE şu anda herhangi bir ücret talep etmemektedir ancak dosyaları EE'ye yüklemeden önce Google Cloud Storage'a aktarmanın küçük bir maliyeti olacaktır. Tipik yükleme veri boyutları (onlarca veya yüzlerce gigabayt) için maliyet oldukça düşük olacaktır.
- Projenizde Cloud Storage API'yi etkinleştirin ve bir paket oluşturun.
- Earth Engine Python istemcisini yükleyin. Bu araç, veri yüklemek için kullanacağımız
earthenginekomut satırı aracını içerir. - Otomatik yüklemeler için projenizle ilişkili bir Google Cloud hizmet hesabı kullanmak isteyebilirsiniz. Test için hizmet hesabına ihtiyacınız yoktur ancak vaktiniz olduğunda hizmet hesaplarını kullanmaya alışmanızı öneririz.
Çok büyük kaynak dosyalar (100 GB veya daha fazla), birden fazla parçaya bölünürse daha hızlı yüklenebilir.
Öğe kimlikleri ve adları
Cloud projesine ait öğeler için şu öğe adı kuralını kullanın:
projects/some-project-id/assets/some-asset-id.
Eski proje ve kullanıcıya ait öğelerin adları hakkında bilgi
Eski projelerde, manifestteki öğe adının Earth Engine'in başka yerlerinde görünen öğe kimliğinden biraz farklı olması gerekir. Öğe kimlikleri users/some_user veya projects/some_project ile başlayan öğeleri yüklemek için manifest dosyasındaki öğe adının, kimliğin önüne eklenmiş projects/earthengine-legacy/assets/ dizesine sahip olması gerekir. Örneğin, EE öğe kimliği users/username/my_geotiff, projects/earthengine-legacy/assets/users/username/my_geotiff adı kullanılarak yüklenmelidir.
Evet, bu durumda projects/some_projects/some_asset gibi kimlikler, projects ifadesinin iki kez geçtiği adlara dönüştürülür: projects/earthengine-legacy/assets/projects/some_projects/some_asset.
Bu durum kafa karıştırıcı olsa da Google Cloud API standartlarına uymak için gereklidir.
Manifestleri kullanma
Aşağıdaki kod bloğunda temel bir manifest gösterilmektedir. gs://earthengine-test adlı Google Cloud Storage paketinden small.tif adlı dosyayı yükler.
{
"name": "projects/some-project-id/assets/some-asset-id",
"tilesets": [
{
"sources": [
{
"uris": [
"gs://earthengine-test/small.tif"
]
}
]
}
]
}Kullanmak için manifest.json adlı bir dosyaya kaydedin ve şunu çalıştırın:
earthengine upload image --manifest /path/to/manifest.json
(gs://earthengine-test/small.tif dosyası mevcut ve herkese açık olarak okunabilir. Bu dosyayı test için kullanabilirsiniz.)
Tilesets
JSON'un biraz karmaşık olan manifest yapısı, yaygın bir yükleme sorununu çözmek için yeterli esnekliği sağlamak amacıyla gereklidir: Birden fazla kaynak dosyadan pikselleri tek bir öğede birleştirmenin tüm olası yollarını açıklama. Dosyaları gruplandırmanın iki bağımsız yolu vardır:
- Mozaikler. Bazen birden fazla dosya birden fazla karoyu temsil eder (örneğin, her karo 1x1 derecelik bir karedir). Bu tür dosyalar, bir EE öğesinde aynı banda mozaiklenmelidir (birleştirilmelidir).
- Ayrı bantlar. Bazen birden fazla dosya, birden fazla bandı temsil eder. Bu tür dosyalar, bir EE öğesinde bantlar olarak birlikte gruplandırılmalıdır.
(Her iki yöntemin de aynı anda kullanılması gerekebilir ancak bu nadir görülen bir durumdur.)
Manifestler, bu seçenekleri açıklamak için karolar kümesi kavramını kullanır. Tek bir karo grubu, tek bir GDAL kaynağına karşılık gelir. Bu nedenle, tek bir karo kümesindeki tüm kaynaklar aynı GDAL yapısına (bant sayısı ve türü, projeksiyon, dönüşüm, eksik değer) sahip olmalıdır. Bir GDAL kaynağında birden fazla bant olabileceğinden bir tileset, birden fazla EE bandı için veri içerebilir.
Mozaik besleme için manifest şu şekilde görünür:
{
"name": "projects/some-project-id/assets/some-asset-id",
"tilesets": [
{
"sources": [
{
"uris": [
"gs://bucket/N30W22.tif"
]
},
{
"uris": [
"gs://bucket/N31W22.tif"
]
}
]
}
]
}Ayrı bantlar için manifest dosyası aşağıdaki gibi görünür (ayrıca aşağıda açıklandığı gibi bir bands bölümü eklemeniz gerekir):
{
"name": "projects/some-project-id/assets/some-asset-id",
"bands": ...,
"tilesets": [
{
"id": "tileset_for_band1",
"sources": [
{
"uris": [
"gs://bucket/band1.tif"
]
}
]
},
{
"id": "tileset_for_band2",
"sources": [
{
"uris": [
"gs://bucket/band2.tif"
]
}
]
}
]
}Ayrı bantlar söz konusu olduğunda, netlik sağlamak için her karo grubuna farklı bir karo grubu kimliği vermemiz gerektiğini unutmayın. Karo grubu kimliği rastgele bir dize olabilir. Bu dizeler, yüklenen öğede tutulmaz. Karo grubu kimlikleri, yalnızca besleme sırasında yığınlanmış karo gruplarını birbirinden ayırt etmek için kullanılır.
Bantlar
İkinci önemli kavram, kaynak dosyaları EE öğe bantlarıyla eşleştirmektir.
Bu işlem, manifest dosyasının bands bölümü kullanılarak yapılır.
bands bölümü atlanabilir. Bu durumda bantlar önce ilk karo grubundaki dosyalardan, ardından sonraki karo grubundan vb. oluşturulur.
Varsayılan olarak bantlar "b1", "b2" vb. olarak adlandırılır. Varsayılan bant adlarını geçersiz kılmak için sonuna aşağıdaki gibi bir "bands" bölümü ekleyin:
{
"name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
"tilesets": [
{
"sources": [
{
"uris": [
"gs://bucket/rgb.tif"
]
}
]
}
],
"bands": [
{
"id": "R",
"tilesetBandIndex": 0
},
{
"id": "G",
"tilesetBandIndex": 1
},
{
"id": "B",
"tilesetBandIndex": 2
}
]
}EE bantlarının sayısı, tüm karo kümelerindeki toplam bant sayısıyla aynı olmalıdır.
Bir dosyadaki tüm bantları almak istemiyorsanız GDAL bantlarından hangilerinin alınması gerektiğini belirtmek için tilesetBandIndex alanını kullanabilirsiniz.
İlk bandın tilesetBandIndex değeri 0'dır.
Örnek:
Kaynak dosyada dört bant olduğunu varsayalım: "tmin", "tmin_error", "tmax", "tmax_error". Yalnızca "tmin" ve "tmax" değerlerini almak istiyoruz. İlgili manifest bölümleri aşağıdaki gibi görünür:
{
"name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
"tilesets": [
{
"id": "temperature",
"sources": [
{
"uris": [
"gs://bucket/temperature.tif"
]
}
]
}
],
"bands": [
{
"id": "tmin",
"tilesetBandIndex": 0,
"tilesetId": "temperature"
},
{
"id": "tmax",
"tilesetBandIndex": 2,
"tilesetId": "temperature"
}
]
}Maske bantları
Bant maskeleme, manifestin maskBands bileşeni tarafından kontrol edilir.
Üç olası maske yapılandırması desteklenir (ancak maske bandının her zaman belirli bir dosyadaki son bant olduğu varsayılır).
- Aynı dosyadaki tüm veri bantları için maske.
- Diğer tüm dosyalardan gelen tüm veri bantları için maske.
- Bazı veri bantları için maske.
1. En yaygın kullanım alanı, son bandı diğer bantlar için maske olarak kullanılan tek bir GeoTIFF'tir. Bu özellik yalnızca Byte türündeki GeoTIFF'lerde çalışır. Aşağıdaki manifesti kullanın:
{
"name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
"tilesets": [
{
"id": "data_tileset",
"sources": [
{
"uris": [
"gs://bucket/data_file.tif"
]
}
]
}
],
"bands": [
{
"id": "data_band",
"tilesetId": "data_tileset"
},
{
"id": "qa_band",
"tilesetId": "data_tileset"
}
],
"maskBands": [
{
"tilesetId": "data_tileset"
}
]
}2. Maske GeoTIFF'i başka bir GeoTIFF'teki tüm bantlar için maske olarak kullanmak istiyorsanız aşağıdaki manifesti kullanın:
{
"name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
"tilesets": [
{
"id": "data_tileset",
"sources": [
{
"uris": [
"gs://bucket/data_file.tif"
]
}
]
},
{
"id": "mask_tileset",
"sources": [
{
"uris": [
"gs://bucket/mask_file.tif"
]
}
]
}
],
"bands": [
{
"id": "data_band",
"tilesetId": "data_tileset"
},
{
"id": "qa_band",
"tilesetId": "data_tileset"
}
],
"maskBands": [
{
"tilesetId": "mask_tileset"
}
]
}3. Bir GeoTIFF'i başka bir dosyadaki belirli bir bandın maskesi olarak kullanmak için aşağıdaki manifesti kullanın (önceki durumdan farkı, maskBands içindeki bandIds alanının ayarlanmış olmasıdır):
{
"name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
"tilesets": [
{
"id": "data_tileset",
"sources": [
{
"uris": [
"gs://bucket/data_file.tif"
]
}
]
},
{
"id": "mask_tileset",
"sources": [
{
"uris": [
"gs://bucket/mask_file.tif"
]
}
]
}
],
"bands": [
{
"id": "data_band",
"tilesetId": "data_tileset"
},
{
"id": "qa_band",
"tilesetId": "data_tileset"
}
],
"maskBands": [
{
"tilesetId": "mask_tileset",
"bandIds": ["data_band"]
}
]
}Son örnekte, data_tileset karo kümesindeki iki bantla çalışıyoruz ancak yalnızca sağlanan tek maskBands liste nesnesinin bandIds alanıyla belirtilen bantlardan birine (data_band) maske uyguluyoruz.
maskBands bölümünde belirtilen karo grubunun yalnızca son bandının maske bandı olarak kullanıldığını unutmayın.
Piramit sistemi politikası
Earth Engine, besleme sırasında görüntü piramitleri oluştururken 2x2 piksellik ızgaraları tekrar tekrar tek bir piksele indirgemek ve piksel değerini bir şekilde dönüştürmek zorundadır. Varsayılan olarak piksel değerlerinin ortalaması alınır. Bu, raster bandı az çok sürekli verileri temsil ettiğinde çoğu durumda doğru olan yöntemdir. Ancak varsayılan değere güvenmenin yanlış sonuçlar üreteceği iki durum vardır. Bu durumlarda, bant tanımındaki pyramidingPolicy alanı ayarlanmalıdır (ayarlanmazsa değerinin varsayılan olarak "MEAN" olduğu varsayılır).
Raster görüntülerin sınıflandırılması için (örneğin, arazi örtüsü sınıflandırması için) pikselleri piramit haline getirmenin en mantıklı yolu, bir sonraki değeri üretmek için dört değerin çoğunluğunu almaktır. Bu işlem, "MODE" piramit oluşturma politikası kullanılarak yapılır:
{
"name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
"tilesets": [
{
"sources": [
{
"uris": [
"gs://bucket/landcover.tif"
]
}
]
}
],
"bands": [
{
"id": "landcover",
"pyramidingPolicy": "MODE"
}
]
}"MEAN" veya "MODE"un anlamlı olmadığı raster bantlar (ör. bit paketli pikseller) için "SAMPLE" piramit oluşturma politikası kullanılmalıdır. "SAMPLE" her zaman her 2x2'lik ızgaranın sol üst pikselinin değerini alır. Aşağıdaki örnekte, sürekli bir değişkeni ("NDVI") temsil eden bir banda "MEAN" piramit oluşturma politikası ve verilerin "QA" bandına "SAMPLE" atanmaktadır.
{
"name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
"tilesets": [
{
"sources": [
{
"uris": [
"gs://bucket/ndvi.tif"
]
}
]
}
],
"bands": [
{
"id": "NDVI",
"tilesetBandIndex": 0,
"pyramidingPolicy": "MEAN"
},
{
"id": "QA",
"tilesetBandIndex": 1,
"pyramidingPolicy": "SAMPLE"
}
]
}Başlangıç ve bitiş zamanı
Özellikle koleksiyonlara dahil edilen tüm öğeler, verilere daha fazla bağlam sağlamak için başlangıç ve bitiş zamanını belirtmelidir. Bu alanlar zorunlu değildir ancak mümkün olduğunda kullanmanızı önemle tavsiye ederiz.
Başlangıç ve bitiş zamanı genellikle gözlem zamanını ifade eder, kaynak dosyanın oluşturulduğu zamanı değil.
Bitiş zamanı, basitlik açısından hariç tutulan bir sınır olarak kabul edilir. Örneğin, tam olarak bir günü kapsayan öğeler için başlangıç ve bitiş zamanı olarak iki ardışık günün gece yarısını (ör. 1980-01-31T00:00:00 ve 1980-02-01T00:00:00) kullanın. Öğenin süresi yoksa bitiş zamanını başlangıç zamanıyla aynı olacak şekilde ayarlayın. Manifestlerdeki saatleri ISO 8601 dizesi olarak gösterin. Tarih değerlerini basitleştirmek için bitiş zamanının hariç tutulduğunu (örneğin, günlük öğeler için sonraki günün gece yarısı) varsaymanızı öneririz.
Örnek:
{
"name": "projects/some-project-id/assets/some-asset-id",
"tilesets": [
{
"sources": [
{
"uris": [
"gs://bucket/img_20190612.tif"
]
}
]
}
],
"startTime": "1980-01-31T00:00:00Z",
"endTime": "1980-02-01T00:00:00Z"
}Manifest yapısı referansı
Aşağıdaki JSON yapısı, olası tüm resim yükleme manifest alanlarını içerir. Alan tanımlarını aşağıdaki Manifest alanı tanımları bölümünde bulabilirsiniz.
{ "name": <string>, "tilesets": [ { "dataType": <string>, "id": <string>, "crs": <string>, "sources": [ { "uris": [ <stringn>> ], "affineTransform": { "scaleX": <double>, "shearX": <double>, "translateX": <double>, "shearY": <double>, "scaleY": <double>, "translateY": <double> } } ] } ], "bands": [ { "id": <string>, "tilesetId": <string>, "tilesetBandIndex": <int32>, "missingData": { "values": [<doublen>>] }, "pyramindingPolicy": <string> } ], "maskBands": [ { "tilesetId": <string>, "bandIds": [ <stringn>> ] } ], "footprint": { "points": [ { "x": <double>, "y": <doublen>> } ], "bandId": <string> }, "missingData": { "values": [<double>] }, "pyramidingPolicy": <string>, "uriPrefix": <string>, "startTime": { "seconds": <integer> }, "endTime": { "seconds": <integer> }, "properties": { <unspecified> } }
Manifest alanı tanımları
ad
string
Oluşturulacak öğenin adı.
name, "projects/*/assets/**" biçimindedir
(örneğin, "projects/earthengine-legacy/assets/users/USER/ASSET").
karolar
list
Karo kümelerinin özelliklerini tanımlayan sözlüklerin listesi.
Daha fazla bilgi için aşağıdaki tilesets sözlük öğesi alanlarına bakın.
tilesets[i].dataType
string
Verilerin sayısal veri türünü belirtir. Varsayılan değer, GDAL'nin raporladığı türdür. Bu durumda tanımlama yapılmasına gerek yoktur.
| Veri türü | Değer |
|---|---|
| Belirtilmedi | "DATA_TYPE_UNSPECIFIED" |
| 8 bit işaretli tam sayı | "INT8" |
| 8 bitlik işaretsiz tam sayı | "UINT8" |
| 16 bit işaretli tam sayı | "INT16" |
| 16 bitlik işaretsiz tam sayı | "UINT16" |
| 32 bit işaretli tam sayı | "INT32" |
| 32 bitlik işaretsiz tam sayı | "UINT32" |
| 32 bit kayan nokta | "FLOAT32" |
| 64 bit kayan nokta | "FLOAT64" |
tilesets[i].id
string
Karo grubunun kimliği. Öğe manifestinde belirtilen karo kümeleri arasında benzersiz olmalıdır. Bu kimlik, işleme adımı sırasında silinir ve yalnızca bir karo grubunu bir banda bağlamak için kullanılır. Boş dize geçerli bir kimliktir.
tilesets[i].crs
string
Piksel ızgarasının koordinat referans sistemi. Mümkünse standart bir kod (ör. EPSG kodu) olarak, aksi takdirde WKT biçiminde belirtilir.
tilesets[i].sources
list
Bir resim dosyasının ve yardımcı dosyalarının özelliklerini tanımlayan sözlüklerin listesi. Daha fazla bilgi için aşağıdaki sources sözlük öğesi alanlarına bakın.
tilesets[i].sources[j].uris
list
Alınacak verilerin URI'lerinin listesi. Yalnızca Google Cloud Storage URI'ları desteklenir. Her URI aşağıdaki biçimde belirtilmelidir:
gs://bucket-id/object-id.
Birincil nesne, listenin ilk öğesi olmalı ve yan arabalar daha sonra listelenmelidir. Her URI, ayarlanmışsa ImageManifest.uriPrefix ile başlar.
tilesets[i].sources[j].affineTransform
dictionary
İsteğe bağlı bir afin dönüşüm. Yalnızca uris verileri (yardımcı dosyalar dahil) pikselleri yerleştirmek için yeterli değilse belirtilmelidir.
Şu anahtarları içeren bir sözlük olarak sağlanır:
"scaleX", "shearX", "translateX", "shearY", "scaleY", "translateY".
Daha fazla bilgi için bu referansa göz atın.
Örnek anahtarlar ve değerler:
{
"scaleX": 0.1,
"shearX": 0.0,
"translateX": -180.0,
"shearY": 0.0,
"scaleY": -0.1,
"translateY": 90.0
}bantlar
list
Bir karo grubundan alınan tek bir bandın özelliklerini tanımlayan sözlüklerin listesi.
Öğenin bant sırasının bands sırasıyla aynı olduğunu unutmayın.
Daha fazla bilgi için aşağıdaki bands sözlük öğesi alanlarına bakın.
bands[i].id
string
Bandın kimliği (adı).
bands[i].tilesetId
string
Banta karşılık gelen karo grubunun kimliği.
bands[i].tilesetBandIndex
int32
Karonun bantla eşleşen sıfır tabanlı bant dizini.
bands[i].missingData.values
list
Bantta veri olmadığını gösteren değerlerin (double türü) listesi.
bands[i].pyramidingPolicy
string
Piramit sistemi politikası. Daha fazla bilgi için bu bağlantıya göz atın. Seçenekler aşağıdakileri içerir:
- "MEAN" (varsayılan)
- "MODE"
- "SAMPLE"
maskBands
list
Bir karo grubundan alınan tek bir maske bandının özelliklerini tanımlayan sözlüklerin listesi.
En fazla 1 maske bandı sağlanabilir.
Daha fazla bilgi için aşağıdaki maskBands sözlük öğesi alanlarına bakın.
maskBands[i].tilesetId
string
Maske bandına karşılık gelen karo kümesinin kimliği. Karo grubunun son bandı her zaman maske bandı olarak kullanılır.
maskBands[i].bandIds
list of strings
Maske bandının uygulandığı bantların kimliklerinin listesi. Boş bırakılırsa maske bandı, öğedeki tüm bantlara uygulanır. Her bandın yalnızca bir karşılık gelen maske bandı olabilir.
ayak izi
dictionary
Bir görüntüdeki tüm geçerli piksellerin ayak izinin özelliklerini tanımlayan bir sözlük.
Boş bırakılırsa varsayılan ayak izi, resmin tamamıdır. Daha fazla bilgi için aşağıdaki footprint sözlük öğesi alanlarına bakın.
footprint.points
list
Bir görüntüdeki tüm geçerli piksellerin kapladığı alanı tanımlayan noktaların listesi. Nokta, kayan değerlere sahip "x" ve "y" anahtarlarını içeren bir sözlükle tanımlanır. Noktaların listesi, görüntünün tüm geçerli piksellerinin merkezlerini içermesi gereken basit bir çokgenin dışını oluşturan bir halkayı tanımlar. Bu, doğrusal bir halka olmalıdır: Son nokta, ilk noktaya eşit olmalıdır. Koordinatlar, bandId tarafından belirtilen bandın projeksiyonundadır.
Not: Her pikselin merkezi gibi tam sayı olmayan koordinatlar kullanın. Çünkü piksel (1x1 dikdörtgen) ayak iziyle kesişiyorsa footprint, bir piksel içerecek şekilde alınır. Yanlışlıkla komşu pikselleri seçmemek için tam sayı değerli koordinatlar kullanmayın. Çünkü bunlar pikseller arasındaki sınırlardır. Ayak izini piksel merkezleri boyunca çizmek, istenmeyen piksellerin dahil edilmesini önler. Bu pikseller, istenen pikseller antimeridyen veya kutup gibi bir harita sınırına bitişik olduğunda hatalara neden olabilir.
Örneğin, dört geçerli pikselin tümünü içeren 2x2'lik bir resim için olası halkalardan biri şöyledir:
[
{
"x": 0.5,
"y": 0.5
},
{
"x": 0.5,
"y": 1.5
},
{
"x": 1.5,
"y": 1.5
},
{
"x": 1.5,
"y": 0.5
},
{
"x": 0.5,
"y": 0.5
}
]footprint.bandId
string
CRS'si, ayak izinin koordinatlarını tanımlayan bandın kimliği. Boşsa ilk bant kullanılır.
missingData.values
list
Görüntünün tüm bantlarında veri olmadığını gösteren değerlerin (double türü) listesi. Kendi missingData değerini belirtmeyen tüm bantlar için geçerlidir.
pyramidingPolicy
string
Piramit sistemi politikası. Belirtilmezse varsayılan olarak "MEAN" politikası uygulanır. Kendi bantlarını belirtmeyen tüm bantlar için geçerlidir. Daha fazla bilgi için bu bağlantıya göz atın. Seçenekler aşağıdakileri içerir:
- "MEAN" (varsayılan)
- "MODE"
- "SAMPLE"
uriPrefix
string
Manifestte tanımlanan tüm uris öğelerinin başına eklenen isteğe bağlı bir ön ek.
startTime
integer
Öğeyle ilişkili zaman damgası (varsa). Bu genellikle bir uydu görüntüsünün çekildiği zamana karşılık gelir. Bir ay veya yıl içindeki ortalama değerler gibi bir zaman aralığına karşılık gelen öğeler için bu zaman damgası, söz konusu aralığın başlangıcına karşılık gelir. Epoch'tan (1970-01-01) bu yana geçen saniye ve (isteğe bağlı olarak) nanosaniye olarak belirtilir. UTC saat diliminde olduğu varsayılır.
endTime
integer
Bir ay veya yıl içindeki ortalama değerler gibi bir zaman aralığına karşılık gelen öğeler için bu zaman damgası, söz konusu aralığın sonuna karşılık gelir (hariç). Epoch'tan (1970-01-01) bu yana geçen saniye ve (isteğe bağlı olarak) nanosaniye olarak belirtilir. UTC saat diliminde olduğu varsayılır.
mülkler
dictionary
Anahtar/değer çiftlerinden oluşan rastgele bir düz sözlük. Anahtarlar dize, değerler ise sayı veya dize olmalıdır. Kullanıcı tarafından yüklenen öğeler için liste değerleri henüz desteklenmiyor.
Sınırlamalar
JSON manifest boyutu
JSON manifest dosyası boyutu sınırı 10 MB'tır. Yüklenecek çok sayıda dosyanız varsa veri kümesini tanımlamak için gereken karakter sayısını azaltmanın yollarını düşünün. Örneğin, uris listesindeki her URI için Google Cloud paketi yolunu sağlama ihtiyacını ortadan kaldırmak üzere uriPrefix alanını kullanın. Boyutun daha da küçültülmesi gerekiyorsa dosya adlarını kısaltmayı deneyin.
Resim dosyası biçimi
Her resim dosyası TIFF resmi olmalıdır. CRS, manifest dosyasında belirtilmemişse dosya, yerleşik CRS içeren bir GeoTIFF olmalıdır.
TIFF dosyaları DEFLATE, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZMA, LZW, WEBP veya ZSTD ile sıkıştırılabilir.
Büyük dosyalar için en iyi yükleme deneyimiyle ilgili öneriler:
- En iyi seçenek: ZSTD, hız ve sıkıştırma arasında iyi bir denge sunar.
- Kaçının: LZMA, iyi sıkıştırma yapmasına rağmen çok yavaş olabilir.
- Sıkıştırılmamış dosyalar: Daha büyük dosyalara ve daha uzun yükleme sürelerine neden olur.
- Kayıplı sıkıştırma (ör. JPEG): Piksel değerlerini değiştirebilir. Verileriniz üzerindeki olası etkiyi anlamadığınız sürece kayıpsız sıkıştırma (ör. DEFLATE, LZMA, LZW, ZSTD) kullanın.