Veri kümesi oluşturma ve yönetme

Veri kümeleri, yerel bir dosyadan veya Google Cloud Storage'dan Google Haritalar Platformu'na coğrafi veriler yüklemenize olanak tanır. Ardından, Cloud Console'da bir veri kümesini bir veya daha fazla harita stiliyle ilişkilendirebilirsiniz. Veri kümesini bir harita stiliyle ilişkilendirdikten sonra, harita uygulamanızı dinamik olarak biçimlendirmek için veri odaklı stil API'sini kullanın.

Coğrafi verilerinizi bir veri kümesine yüklemek için REST API'yi de kullanabilirsiniz. Daha fazla bilgi için Maps Datasets API'ye bakın

Rolleri yapılandırma

Bir Google Cloud projesinde veri kümesi oluşturmak ve yönetmek için projede Sahip veya Düzenleyici IAM rolüne sahip olmanız gerekir.

Alternatif olarak, veri kümelerini yönetmek için kullandığınız bir kullanıcı hesabına veya hizmet hesabına aşağıdaki IAM rollerini atayabilirsiniz:

• Maps Platform Datasets Admin rolü, kullanıcıya veya hizmet hesabına projedeki veri kümelerine okuma/yazma erişimi verir. Bu rol, kullanıcının bir veri kümesinde tüm işlemleri gerçekleştirmesine olanak tanır.
• Maps Platform Datasets Viewer rolü, projedeki veri kümelerine salt okuma erişimi verir. Bu rol, bir veri kümesinde listeleme, getirme veya indirme işlemi gerçekleştirmenize olanak tanır.

Daha fazla bilgi için Google Cloud Console'u kullanarak IAM rolü verme başlıklı makaleyi inceleyin.

Veri kümesinin veri kaynağı

• Cloud Storage'dan veri yüklerken, Cloud Storage'da verileri içeren kaynağın dosya yolunu belirtin. Bu yol şu biçimdedir: gs://GCS_BUCKET/FILE.

  İsteği gönderen kullanıcının Depolama Alanı Nesnesi Görüntüleyen rolüne veya storage.objects.get iznini içeren başka bir role sahip olması gerekir. Cloud Storage'a erişimi yönetme hakkında daha fazla bilgi için Erişim denetimine genel bakış başlıklı makaleyi inceleyin.

• Yerel bir dosyadan veri yüklerken, yüklenecek verileri içeren GeoJSON, KML veya CSV dosyasının yolunu belirtin.

Ö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 olarak 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. WKT biçimindeki "Z" soneki ve GeoJSON biçimindeki yükseklik koordinatı buna dahildir.

Veri hazırlama ile ilgili en iyi uygulamalar

Kaynak verileriniz yoğun noktalar, uzun çizgi dizileri veya poligonlar gibi karmaşıksa ya da büyükse (genellikle 50 MB'tan büyük kaynak dosyası boyutları bu kategoriye girer) görsel haritalarda en iyi performansı elde etmek için yüklemeden önce verilerinizi basitleştirmeyi düşünebilirsiniz.

Verilerinizi hazırlamayla ilgili en iyi uygulamalardan bazıları şunlardır:

1. Özellik özelliklerini en aza indirin. Yalnızca haritanıza stil uygulamak için gereken özellik özelliklerini (ör. "id" ve "category") tutun. Benzersiz tanımlayıcı anahtarında veriye dayalı stilleri kullanarak istemci uygulamasındaki bir özelliğe ek özellikler ekleyebilirsiniz. Örneğin, Veriye dayalı stilizasyon ile verilerinizi gerçek zamanlı olarak görme başlıklı makaleyi inceleyin.
2. Kart boyutunu en aza indirmek ve harita performansını artırmak için mümkün olduğunda tesis nesneleri için basit veri türleri kullanın (ör. tam sayılar).
3. Dosya yüklemeden önce karmaşık geometrileri basitleştirin. Bunu, açık kaynak Mapshaper.org yardımcı programı gibi seçtiğiniz bir coğrafi araçta veya karmaşık poligon geometrilerinde ST_Simplify işlevini kullanarak BigQuery'de yapabilirsiniz.
4. Dosya yüklemeden önce çok yoğun noktaları kümelendirin. Bunu, açık kaynak turf.js küme işlevleri gibi dilediğiniz bir coğrafi araçta veya yoğun nokta geometrilerinde ST_CLUSTERDBSCAN'ı kullanarak BigQuery'de yapabilirsiniz.

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

GeoJSON koşulları

Maps JavaScript API, mevcut GeoJSON spesifikasyonunu destekler. Haritalar JavaScript 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, bir geometrinin yanı sıra anlamları uygulamaya özgü olan ek ad/değer çiftleri içerir.
• Özellik koleksiyonları. Özellik koleksiyonu, bir özellik nesnesi grubudur.

Haritalar JavaScript API'si, WGS84 dışında bir koordinat referans sisteminde (CRS) veri içeren GeoJSON dosyalarını desteklemez.

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

KML koşulları

Maps JavaScript API'nin aşağıdaki koşulları karşılaması gerekir:

• Tüm URL'ler dosyanın kendisine yerel (veya göreli) olmalıdır.
• Nokta, çizgi ve poligon geometrileri desteklenir.
• Tüm veri özellikleri dize olarak kabul edilir.

• Dosya dışında tanımlanan simgeler veya <styleUrl>.
• <NetworkLink> gibi ağ bağlantıları
• <GroundOverlay> gibi zemin bindirmeleri
• 3D geometriler veya <altitudeMode> gibi rakımla ilgili etiketler
• <LookAt> gibi kamera özellikleri
• KML dosyasında tanımlanan stiller.

CSV koşulları

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
• Tüm adres bilgilerini içeren tek bir sütun (ör. 1600 Amphitheatre Parkway Mountain View, CA 94043)

Örneğin, dosyanızda x, y ve wkt adlı sütunlar var. Yukarıdaki listede desteklenen sütun adlarının sırasına göre belirlendiği üzere x ve y 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 bulunabilir.

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ında, her bir Feature nesnesi ve Geometry nesnesi tanımının parçası olarak type adlı bir dize alanı bulunmalıdır.

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ütunu için değerler eksik. CSV dosyasındaki tüm satırlar, geometri sütunları için boş olmayan değerler içermelidir. 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 (ör. 1600 Amphitheatre Parkway Mountain View, CA 94043)
• 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 verilerde veri kümesi noktaları beklenmedik konumlarda gösterilebilir.

Veri kümesi oluşturma

Veri kümesi oluşturmak için:

1. Google Cloud Console'da Veri kümeleri sayfasına gidin.
2. Veri Kümesi Oluştur'u tıklayın.
3. Veri kümesi adını girin. Ad, tüm veri kümeleri arasında benzersiz olmalıdır.
4. İsteğe bağlı olarak bir veri kümesi Açıklama girin.
5. Devam'ı tıklayın. Verileri içe aktar sayfası görüntülenir.
6. Veri kümesini doldurmak için kullanılan verilerin Yükleme kaynağı'nı Masaüstü (sisteminizdeki yerel bir dosya) veya Google Cloud Storage paketi olarak seçin.
   • Masaüstü için Göz at'ı tıklayın ve ardından dosya seçiciden dosyayı seçin.
   • Google Cloud Storage paketi için Göz at'ı tıklayın ve verileri içeren paketi ve dosyayı seçin.
7. Dosya biçimini seçin.
8. Ayarlarınızı incelemek için Devam'ı tıklayın.

9. Oluştur'u tıklayın. Yeni veri kümenizi gösteren Veri Kümeleri sayfası görünür. Durum İşleniyor olmalıdır.

   Veriler başarıyla yüklenirse:

   • Veri kümesinin durumu TAMAMLANMIŞ olarak ayarlanır.
   • Veri kümesi, "etkin" sürüm olur ve uygulamanız tarafından kullanılan sürümdür.

   Yüklemede hata varsa:

   • Yeni veri kümesi sürümünün durumu TAMAMLANMIŞ dışında bir duruma ayarlanmışsa

Veri kümesini görüntüleme veya değiştirme

Oluşturduğunuz veri kümesini görüntüleyebilir veya değiştirebilirsiniz:

1. Google Cloud Console'da Veri kümeleri sayfasına gidin.
2. Veri kümesinin adını tıklayın. Veri kümesi ayrıntıları sayfası görünür.
   1. Veri kümesiyle ilgili bilgileri görmek için Ayrıntılar sekmesini tıklayın. Bu sekmede, veri kümesi adını ve açıklamasını da düzenleyebilirsiniz.
   2. Veri kümenizi haritada görmek için Önizleme sekmesini tıklayın (yalnızca TAMAMLANMIŞ veya GERİ DÖNDÜRÜLMÜŞ durumundaki veri kümeleri).
   3. Veri kümesinin tüm özelliklerini (yalnızca TAMAMLANDI veya GERİ DÖNDÜRÜLDÜ durumundaki veri kümeleri) görmek için Tablo Verileri sekmesini tıklayın. Bunlar, haritadaki veri kümesine stil uygulamak için kullanabileceğiniz özelliklerdir.
   4. Verileri yerel bir dosyaya indirmek için İndir düğmesini tıklayın.
   5. Veri kümesini silmek için Sil düğmesini tıklayın.

   6. Veri kümesine yeni veri yüklemek için Veri Dosyası İçe Aktar düğmesini tıklayın.

      Veri kümesine yeni veri yüklediğinizde veri kümesinin yeni bir sürümü oluşturulur. Yeni veriler başarıyla yüklenirse:

      • Veri kümesinin yeni sürümünün durumu TAMAMLANDI olarak ayarlanır.
      • Yeni sürüm, "etkin" sürüm olur ve uygulamanız tarafından kullanılan sürümdür.

      Yüklemede hata varsa:

      • Yeni veri kümesi sürümünün durumu TAMAMLANMIŞ dışında bir duruma ayarlanmışsa Örneğin, önceki bir "etkin" sürüm varsa veri kümesinin durumu GERİ DÖNDÜRÜLDÜ olarak ayarlanır.
      • Daha önce "etkin" olan veri kümesi sürümü "etkin" sürüm olarak kalır ve uygulamanız tarafından kullanılan sürümdür.