Başlamadan önce

Bu belgede, veri kümeleriyle çalışırken ön koşullar, en iyi uygulamalar ve yaygın hatalar açıklanmaktadır.

Ö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ısa olmalıdır (Bu karakterler UTF-8'de temsil edildiğinden bazı dillerde her karakter birden fazla baytla temsil edilebilir).
  • Açıklamalar 1.000 bayttan kısa olmalıdır.

Veri yüklerken:

  • Desteklenen dosya türleri CSV, GeoJSON ve KML'dir.
  • Desteklenen maksimum dosya boyutu 500 MB'tır.
  • Özellik sütunu adları "?_" dizesiyle başlayamaz.
  • Üç boyutlu geometriler desteklenmez. Bu, WKT biçimindeki "Z" sonekini ve GeoJSON biçimindeki yükseklik koordinatını içerir.

Veri hazırlamayla ilgili en iyi uygulamalar

Kaynak verileriniz karmaşık veya büyükse (ör. yoğun noktalar, uzun çizgi dizeleri ya da poligonlar) (genellikle 50 MB'tan büyük kaynak dosyalar bu kategoriye girer) görsel haritada en iyi performansı elde etmek için yüklemeden önce verilerinizi basitleştirin.

Verilerinizi hazırlarken izleyebileceğiniz bazı en iyi uygulamaları aşağıda bulabilirsiniz:

  1. Özellik mülklerini en aza indirin. Haritanızı şekillendirmek için gereken özellik özelliklerini (ör. "id" ve "category") saklayın. Benzersiz tanımlayıcı anahtarında veriye dayalı stiller kullanarak bir istemci uygulamasındaki özelliğe ek mülkler ekleyebilirsiniz. Örneğin, Veriye dayalı stil ile verilerinizi anlık olarak görme başlıklı makaleyi inceleyin.
  2. Döşeme boyutunu küçültmek ve harita performansını artırmak için mümkün olduğunda mülk nesnelerinde basit veri türlerini (ör. tam sayılar) kullanın.
  3. Dosya yüklemeden önce karmaşık geometrileri basitleştirin. Bu işlemi, açık kaynaklı Mapshaper.org yardımcı programı gibi istediğiniz bir coğrafi araçta veya BigQuery'de ST_Simplify kullanarak karmaşık poligon geometrilerinde yapabilirsiniz.
  4. Dosya yüklemeden önce çok yoğun noktaları kümeleyin. Bu işlemi, açık kaynaklı turf.js küme işlevleri gibi tercih ettiğiniz bir coğrafi araçta veya BigQuery'de ST_CLUSTERDBSCAN kullanarak yoğun nokta geometrileri üzerinde yapabilirsiniz.

Veri kümeleriyle ilgili en iyi uygulamalar hakkında ek bilgi için Verilerinizi veri kümeleri ve BigQuery ile görselleştirme başlıklı makaleyi inceleyin.

GeoJSON gereksinimleri

Haritalar Veri Kümeleri API'si, mevcut GeoJSON spesifikasyonunu destekler. Haritalar Veri Kümeleri API'si, aşağıdaki nesne türlerinden herhangi birini içeren GeoJSON dosyalarını da destekler:

  • Geometri nesneleri. Geometri nesnesi, isteğe bağlı deliklere sahip noktaların, çizgilerin ve poligonların birleşimi olarak tanımlanan bir uzamsal şekildir.
  • Özellik nesneleri. Bir özellik nesnesi, geometri ve ek ad/değer çiftleri içerir. Bu çiftlerin anlamı uygulamaya özeldir.
  • Özellik koleksiyonları. Özellik koleksiyonu, bir dizi özellik nesnesidir.

Maps Datasets API, WGS84 dışında bir koordinat referans sisteminde (CRS) verileri olan GeoJSON dosyalarını desteklemez.

GeoJSON hakkında daha fazla bilgi için RFC 7946 uyumlu başlıklı makaleyi inceleyin.

KML koşulları

Maps Datasets API'nin aşağıdaki şartları karşılaması gerekir:

  • Tüm URL'ler, dosyanın kendisiyle ilgili yerel (veya göreli) olmalıdır.
  • Nokta, çizgi ve poligon geometrileri desteklenir.
  • Tüm veri özellikleri dize olarak kabul edilir.
Aşağıdaki KML özellikleri desteklenmez:
  • Dosyanın dışında tanımlanan simgeler veya <styleUrl>.
  • <NetworkLink> gibi ağ bağlantıları
  • <GroundOverlay> gibi yer paylaşımları
  • 3D geometriler veya <altitudeMode> gibi yükseklikle ilgili etiketler
  • <LookAt> gibi kamera özellikleri
  • KML dosyasında tanımlanan stiller.

CSV gereksinimleri

CSV dosyaları için desteklenen sütun adları aşağıda öncelik sırasına göre listelenmiştir:

  • latitude, longitude
  • lat, long
  • x, y
  • wkt (Well-Known Text)
  • address, city, state, zip
  • address
  • 1600 Amphitheatre Parkway Mountain View, CA 94043 gibi tüm adres bilgilerini içeren tek bir sütun

Örneğin, dosyanızda x, y ve wkt adlı sütunlar var. x ve y, yukarıdaki listede desteklenen sütun adlarının sırasına göre belirlendiği üzere daha yüksek önceliğe sahip olduğundan 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. Yani, hem x hem de y koordinat verilerini içeren xy adlı bir sütununuz olamaz. X ve Y koordinatları ayrı sütunlarda olmalıdır.
  • 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ızda lat ve long sütunları varsa bunlar herhangi bir sırada yer alabilir.

Veri yükleme hatalarını giderme

Bir veri kümesine veri yüklerken bu bölümde açıklanan yaygın hatalardan biriyle karşılaşabilirsiniz.

GeoJSON hataları

Sık karşılaşılan GeoJSON hataları şunlardır:

  • type alanı eksik veya type bir dize değil. Yüklenen GeoJSON veri dosyası, her Feature nesnesi ve Geometry nesnesi tanımının bir parçası olarak type adlı bir dize alanı içermelidir.

KML hataları

Sık karşılaşılan KML hataları şunlardır:

  • Veri dosyası, yukarıda listelenen desteklenmeyen KML özelliklerinden 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 geometri sütununa ait değerler eksik. CSV dosyasındaki tüm satırlar, geometri sütunları için boş olmayan değerler içermelidir. Geometri sütunları şunlardır:
    • latitude, longitude
    • lat, long
    • x, y
    • wkt
    • address, city, state, zip
    • address
    • 1600 Amphitheatre Parkway Mountain View, CA 94043 gibi tüm adres bilgilerini içeren tek bir sütun
  • x ve y, geometri sütunlarınızsa birimlerin boylam ve enlem olduğundan emin olun. Bazı herkese açık veri kümeleri, x ve y başlıkları altında farklı koordinat sistemleri kullanır. Yanlış birimler kullanılırsa veri kümesi başarıyla içe aktarılabilir ancak oluşturulan veriler, veri kümesi noktalarını beklenmedik konumlarda gösterebilir.