Bu belgede ön koşullar, en iyi uygulamalar ve sık karşılaşılan hatalar açıklanmaktadır bazı yöntemleri inceleyelim.
Ön koşullar
Veri kümesi oluştururken:
- Görünen adlar, Google Cloud projenizde benzersiz olmalıdır.
- Görünen adlar 64 bayttan küçük olmalıdır (Bu karakterler UTF-8'de temsil edildiğinden, bazı dillerde her karakter birden çok baytla temsil edilebilir).
- Açıklamalar 1.000 bayttan küçük olmalıdır.
Veri yüklerken:
- Desteklenen dosya türleri CSV, GeoJSON ve KML'dir.
- Maksimum dosya boyutu 500 MB'tır.
- Özellik sütunu adları "?_" dizesiyle başlayamaz.
- Üç boyutlu geometriler desteklenmez. Buna "Z" dahildir WKT biçiminde son ek, ve rakım koordinatı, GeoJSON biçimindedir.
Veri hazırlamayla ilgili en iyi uygulamalar
Yoğun noktalar, uzun çizgi dizeleri veya poligonlar gibi kaynak verileriniz karmaşık veya büyükse (genellikle 50 MB'tan büyük kaynak dosya boyutları bu kategoriye girer). Verilerinizi basitleştirmeyi düşünün. görsel haritada en iyi performansı elde etmek için yüklemeden önce bakın.
Verilerinizi hazırlamaya yönelik en iyi uygulamalardan bazıları şunlardır:
- Özellik özelliklerini en aza indirin. Yalnızca stil belirlemek için gereken özellik özelliklerini koru haritanız (ör. "id") ve "category". Bir istemcideki özelliğin ek mülklerini ekleyebilirsiniz benzersiz tanımlayıcı anahtarında veriye dayalı stiller kullanan bir uygulamadır. Örneğin, bkz. Veriye dayalı stil ile verilerinizi gerçek zamanlı olarak görün.
- Mümkün olduğunda tamsayılar, kullanarak karo boyutunu küçültün ve harita performansını artırın.
- Bir dosya yüklemeden önce karmaşık geometrileri basitleştirin. Bu işlemi seçtiğiniz jeo-uzamsal araç (ör. açık kaynak Mapshaper.org yardımcı programını kullanarak veya ST_Simplify geometrik şekiller ve grafiklerdir.
- Bir dosya yüklemeden önce çok yoğun noktaları kümeleyin. Bu işlemi seçtiğiniz jeo-uzamsal araç (ör. açık kaynak turf.js küme işlevleri olarak veya BigQuery'de ST_CLUSTERDBSCAN kullanılarak GeoX çalışması yapmaya karar verdi.
Veri kümeleriyle ilgili en iyi uygulamalar hakkında daha fazla bilgi için Veri kümeleri ve BigQuery ile verilerinizi görselleştirin.
GeoJSON gereksinimleri
Maps Datasets API, mevcut GeoJSON spesifikasyonu. Maps Datasets API, aşağıdaki nesne türlerinden herhangi birini içeren GeoJSON dosyalarını da destekler:
- Geometri nesneleri. Geometri nesnesi, birleşim olarak tanımlanan mekansal bir şekildir noktaların, çizgilerin ve poligonların sayısını gösterir.
- Nesneleri öne çıkarın. Özellik nesnesi bir geometri ve buna ek olarak (anlamı uygulamaya özgü olan ad/değer çiftleri).
- Özellik koleksiyonları. Özellik koleksiyonu, özellik nesnelerinden oluşan bir gruptur.
Haritalar Veri Kümeleri API'si, koordinat referans sisteminde veri içeren GeoJSON dosyalarını desteklemez WGS84 dışında (CRS) kullanmayın.
GeoJSON hakkında daha fazla bilgi için bkz. RFC 7946 uyumlu.
KML gereksinimleri
Haritalar Veri Kümeleri API'si aşağıdaki şartlara sahiptir:
- Tüm URL'ler, dosyanın kendisinde yerel (veya göreli) olmalıdır.
- Nokta, çizgi ve poligon geometrileri desteklenir.
- Tüm veri özellikleri dize olarak kabul edilir.
- Dosyanın dışında tanımlanmış simgeler veya
<styleUrl>
. - Ağ bağlantıları, ör.
<NetworkLink>
<GroundOverlay>
gibi zemin bindirmeler- 3D geometriler veya
<altitudeMode>
gibi rakımla ilgili etiketler - Kamera özellikleri (ör.
<LookAt>
) - KML dosyasında tanımlanan stiller.
CSV koşulları
CSV dosyaları için, desteklenen sütun adları öncelik sırasına göre aşağıda listelenmiştir:
latitude
,longitude
lat
,long
x
,y
wkt
(İyi Bilinen Metin)address
,city
,state
,zip
address
- Tüm adres bilgilerini içeren tek bir sütun, örneğin
1600 Amphitheatre Parkway Mountain View, CA 94043
.
Örneğin, dosyanız x
, y
ve wkt
adlı sütunlar içeriyor.
x
ve y
, tarama sırasına göre daha yüksek bir önceliğe sahip olduğu için
desteklenen sütun adları şunlardır: x
ve y
sütunlarındaki değerler
kullanılır ve wkt
sütunu yoksayılır.
Ayrıca:
- Her sütun adı tek bir sütuna ait olmalıdır. Diğer bir deyişle,
Hem x hem de y koordinat verilerini içeren
xy
. x ve y koordinatlarının içinde olmalıdır ayrı sütunlar oluşturabilirsiniz. - Sütun adları büyük/küçük harfe duyarlı değildir.
- Sütun adlarının sırası önemli değildir. Örneğin, CSV dosyanız
lat
velong
sütunları herhangi bir sırada olabilir.
Veri yükleme hatalarını işleme
Bir veri kümesine veri yüklerken, bu makalede açıklanan yaygın hatalardan biriyle karşılaşabilirsiniz: bölümüne ekleyin.
GeoJSON hataları
Yaygın GeoJSON hataları şunlardır:
type
alanı eksik veyatype
bir dize değil. Yüklenen GeoJSON veri dosyası, her bir değerin parçası olaraktype
adlı bir dize alanı içermelidir Özellik nesnesi ve Geometri nesne tanımı.
KML hataları
Yaygın KML hataları şunlardır:
- Veri dosyası yukarıda listelenen desteklenmeyen KML özelliklerinin hiçbirini içermemelidir, aksi takdirde veri içe aktarma işlemi başarısız olabilir.
CSV hataları
Sık karşılaşılan CSV hataları şunlardır:
- Bazı satırlarda bir geometri sütunu için değer eksik. CSV dosyasındaki tüm satırlar şunları içermelidir:
boş olmayan değerleri girin. Geometri sütunları şunları içerir:
latitude
,longitude
lat
,long
x
,y
wkt
address
,city
,state
,zip
address
- Tüm adres bilgilerini içeren tek bir sütun, örneğin
1600 Amphitheatre Parkway Mountain View, CA 94043
.
- Geometri sütunlarınız
x
vey
ise birimlerin boylam ve enlem. Bazı herkese açık veri kümeleri, başlıkların altında farklı koordinat sistemleri kullanır.x
vey
. Yanlış birimler kullanılırsa veri kümesi içe aktarılabilir başarılı bir şekilde çalışır, ancak oluşturulan veriler beklenmedik konumlardaki veri kümesi noktalarını gösterebilir.