Başlamadan önce

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.
ziyaret edin.

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:

  1. Ö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.
  2. Mümkün olduğunda tamsayılar, kullanarak karo boyutunu küçültün ve harita performansını artırın.
  3. 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.
  4. 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.
ziyaret edin. Aşağıdaki KML özellikleri desteklenmez:
  • 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 ve long 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 veya type bir dize değil. Yüklenen GeoJSON veri dosyası, her bir değerin parçası olarak type 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.
    ziyaret edin.
  • Geometri sütunlarınız x ve y ise birimlerin boylam ve enlem. Bazı herkese açık veri kümeleri, başlıkların altında farklı koordinat sistemleri kullanır. x ve y. 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.