Veri kümesi oluşturma ve yönetme

Bu ürün veya özellik Önizleme sürümündedir (GKST öncesi). GKST öncesi ürünlere ve özelliklere verilen destek sınırlı olabilir. Ayrıca, GKST öncesi ürünler ve özelliklerde yapılan değişiklikler GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmetine Özel Şartlar kapsamındadır. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

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

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

Rolleri yapılandırma

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

Not: Projeyi siz oluşturduysanız projede Sahip rolünüz vardır. Google Cloud Console'un IAM sayfasında proje sahipleri ve düzenleyicileri gösterilir.

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ı veya hizmetler 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, veri kümesi üzerinde listeleme, alma veya indirme işlemleri gerçekleştirmenize olanak tanır.

Daha fazla bilgi için Google Cloud Console'u kullanarak IAM rolü verme bölümünü inceleyin.

Veri kümesinin veri kaynağı

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

Not: Bir veri kümesine yalnızca bir kez veri yükleyebilirsiniz. Yani Cloud Storage'dan veya yerel bir dosyadan veri yükleme isteğini gerçekleştirdikten sonra verileri tekrar aynı veri kümesine yükleyemezsiniz. Yükleme sırasında bir hata oluşursa veri kümesini yeniden oluşturmanız ve yüklemeyi tekrar denemeniz gerekir.

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

  İsteği yapan kullanıcının Storage Nesne Görüntüleyici 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ış sayfasını inceleyin.

• Verileri yerel bir dosyadan 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 projeniz içinde benzersiz olmalıdır.
• Görünen adlar 64 bayttan küçük olmalıdır (Bu karakterler UTF-8 olarak temsil edildiği için bazı dillerde her karakter birden fazla baytla temsil edilebilir).
• Açıklamaların boyutu 1.000 bayttan az olmalıdır.

Verileri 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.

Not: Veri dosyasının boyutuna bağlı olarak yükleme işlemi birkaç dakika, hatta birkaç saat sürebilir. Yükleme ile ilgili bir hata varsa bir hata mesajı alırsınız. Yükleme işleminden bir yanıt döndürene kadar veri kümesini silmeye çalışmayın.

İpucu: Veri dosyanız büyükse ve içinde stil için gerekli olmayan birçok özellik varsa ve oluşturma performansını optimize etmek istiyorsanız gereksiz özellikleri kaldırmak için dosyayı düzenleyin. Özellik sayısının azaltılması harita parçalarının boyutunu küçülterek oluşturma performansını iyileştirir.

GeoJSON gereksinimleri

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

• Geometri nesneleri. Geometri nesnesi, isteğe bağlı delikleri olan noktalar, çizgiler ve poligonların birleşimi olarak tanımlanan uzamsal bir şekildir.
• Nesneleri öne çıkarın. Özellik nesnesi, bir geometri ve ek ad/değer çiftleri içerir. Bu çiftlerin anlamları uygulamaya özeldir.
• Özellik koleksiyonları. Özellik koleksiyonu, bir dizi özellik nesnesidir.

Maps JavaScript API, WGS84 dışında bir koordinat referans sisteminde (CRS) veriler içeren GeoJSON dosyalarını desteklemez.

GeoJSON hakkında daha fazla bilgi için RFC 7946 uyumlu bölümüne 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 desteklenmez:

• Dosyanın dışında tanımlanmış simgeler veya <styleUrl>.
• <NetworkLink> gibi ağ bağlantıları
• <GroundOverlay> gibi yer paylaşımları
• 3D geometriler veya rakımla ilgili etiketler (ör. <altitudeMode>)
• <LookAt> gibi kamera özellikleri
• KML dosyasında tanımlanan stiller.

CSV gereksinimleri

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
• 1600 Amphitheatre Parkway Mountain View, CA 94043 gibi tüm adres bilgilerini içeren tek bir sütun

Örneğin, dosyanız x, y ve wkt adlı sütunlar içeriyor. Yukarıdaki listede yer alan desteklenen sütun adlarının sırasına göre belirlendiği üzere x ve y daha yüksek bir önceliğe sahip olduğu için 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 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ını içeriyorsa bunlar herhangi bir sırada gerçekleşebilir.

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ı

Yaygın GeoJSON hataları şunlardır:

• type alanı eksik veya type bir dize değil. Yüklenen GeoJSON veri dosyası, her Özellik nesnesinin ve Geometri nesne tanımının parçası olarak type adlı bir dize alanı içermelidir.

KML hataları

Yaygın 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 bir 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
  • 1600 Amphitheatre Parkway Mountain View, CA 94043 gibi tüm adres bilgilerini içeren tek bir sütun
  Not: Bu hata genellikle "' ' çifte dönüştürülemedi" veya "Giriş coğrafyaya ayrıştırılamadı: Coğrafi değer eksik".
• Geometri sütunlarınız x ve y ise 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.

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çıklaması 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ü'nde 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ıp verileri içeren paket 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ünür. Durum, İşleniyor olmalıdır.
10. Veri kümenizin durumu Tamamlandı olana kadar bekleyin.

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

Başarıyla oluşturulan bir veri kümesinin 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ümesi adını ve açıklamasını da düzenleyebilirsiniz.
   2. Veri kümenizi haritada görmek için Önizleme sekmesini tıklayın.
   3. Veri kümesiyle ilişkili 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.