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 veri yüklemenize olanak tanır. Daha sonra, Cloud Console'da bir veya daha fazla harita stiliyle bir veri kümesini ilişkilendirebilirsiniz. Veri kümesini harita stiliyle ilişkilendirdikten sonra harita uygulamanızın stilini dinamik olarak ayarlamak için veriye dayalı stil API'sini kullanın.

Coğrafi verileri bir veri kümesine yüklemek için REST API'yi de kullanabilirsiniz. Daha fazla bilgi için Haritalar Veri Setleri API'si bölümüne bakın

Rolleri yapılandır

Bir Google Cloud projesinde veri kümeleri oluşturup 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 kullanıcı hesabına veya hizmet hesabına aşağıdaki IAM rollerini atayabilirsiniz:

  • Maps Platform Datasets Admin rolü, kullanıcı veya hizmet hesabına projedeki veri kümelerine okuma/yazma erişimi verir. Bu rol, kullanıcının bir veri kümesindeki 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 liste veya alma işlemi gerçekleştirmenize ya da indirmenize olanak tanır.

Daha fazla bilgi için Google Cloud Console'u kullanarak IAM rolü atama bölümüne bakın.

Veri kümesi için veri kaynağı

Veri kümesi oluşturduktan sonra, verileri Google Cloud Storage'dan veya bir yerel dosyadan veri kümesine yükleyin.

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

    İstekte bulunan kullanıcı için Storage Nesne Görüntüleyici rolü veya storage.objects.get iznini içeren başka bir rol gerekir. Cloud Storage'a erişimi yönetme hakkında daha fazla bilgi için Erişim denetimine genel bakış sayfasını 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 az olmalıdır (Çünkü bu karakterler UTF-8 olarak temsil edilir ve bazı dillerde her karakter birden fazla baytla temsil edilebilir).
  • Açıklamalar 1.000 bayttan az olmalıdır.

Veri yüklerken:

  • Desteklenen dosya türleri CSV, GeoJSON ve KML'dir.
  • Desteklenen maksimum dosya boyutu 350 MB'tır.
  • Özellik sütunu adları "?_" dizesiyle başlayamaz.
  • Üç boyutlu geometriler desteklenmez. Buna, WKT biçiminde "Z" son eki ve GeoJSON biçiminde rakım koordinatı dahildir.

GeoJSON gereksinimleri

Maps JavaScript API, mevcut GeoJSON spesifikasyonunu destekler. Maps JavaScript API, aşağıdaki nesne türlerinden birini içeren GeoJSON dosyalarını da destekler:

  • Geometri nesneleri. Geometri nesnesi, isteğe bağlı delikler içeren noktalar, çizgiler ve poligonların birleştirilmesi olarak tanımlanan uzamsal bir şekildir.
  • Nesneleri öne çıkarın. Özellik nesnesi, bir geometriye ve uygulamaya özel olan ek ad/değer çiftlerine sahiptir.
  • Özellik koleksiyonları. Özellik koleksiyonu, bir özellik nesnesi grubudur.

Maps JavaScript API, 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 konusuna bakın.

KML gereksinimleri

Maps JavaScript API 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.
Aşağıdaki KML özellikleri desteklenmiyor:
  • Dosyanın dışında tanımlanmış 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ının içinde 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 (İyi Bilinen Metin)
  • 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ız x, y ve wkt adlı sütunlar içeriyor. x ve y, yukarıdaki listede desteklenen sütun adlarının sırasına göre belirlendiğinden daha yüksek bir ö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ız lat ve long sütunları içeriyorsa herhangi bir sırada olabilirler.

Veri yükleme hatalarını işleme

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 bir özellik nesnesi ve Geometri nesne tanımının parçası olarak type adlı bir dize alanı içermelidir.

KML hataları

Sık karşılaşılan KML hataları arasında şunlar bulunur:

  • 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 geometri sütununun değeri eksik. Bir 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
    • Tüm adres bilgilerini içeren tek bir sütun (ör. 1600 Amphitheatre Parkway Mountain View, CA 94043)
  • Geometri sütunlarınız x ve y ise birimlerin boylam ve enlem değerlerini girin. Bazı herkese açık veri kümeleri, x ve y başlıklarının 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ı beklenmeyen yerlerde gösterebilir.

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ümesinin 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çıklaması girin.
  5. Devam'ı tıklayın. Verileri içe aktarın sayfası görüntülenir.
  6. Veri kümesini Masaüstü olarak (sisteminizdeki yerel bir dosya veya Google Cloud Storage paketi olarak) doldurmak için kullanılan verilerin yükleme kaynağını seçin.
    • Masaüstü için Göz at'ı tıklayın, 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çimi'ni 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üntülenir. Durum İşleniyor olmalıdır.
  10. Veri kümenizin Tamamlandı durumuna geçmesini bekleyin.

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

Başarılı bir şekilde oluşturulan veri kümesi durumu Tamamlandı olarak görünür. Ardından veri kümesinin ayrıntılarını inceleyebilirsiniz.

Veri kümesini görüntülemek için:

  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üntülenir.
    1. Veri kümesiyle ilgili bilgileri görmek için Ayrıntılar sekmesini tıklayın. Bu sekmede, veri kümesinin adını ve açıklamasını da düzenleyebilirsiniz.
    2. Veri kümenizi bir harita üzerinde görmek için Önizleme sekmesini tıklayın.
    3. Veri kümesiyle ilişkilendirilen verilerin bir alt kümesini görmek için Tablo Verileri sekmesini tıklayın.
    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.