Veri kümesi oluşturma ve yönetme

Veri kümeleri, coğrafi verileri yerel bir dosyadan veya Google Cloud Storage'dan Google Haritalar Platformu'na yüklemenize olanak tanır. Daha sonra 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ı dinamik olarak biçimlendirmek için veriye dayalı stil API'sini kullanın.

Coğrafi verilerinizi bir veri kümesine yüklemek için REST API'si de kullanabilirsiniz. Daha fazla bilgi için Haritalar Veri Kümeleri API'si sayfasına göz atın.

Rolleri yapılandırma

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 bir 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ümeleri için okuma/yazma erişimi verir. Bu rol, kullanıcının bir veri kümesindeki tüm işlemleri gerçekleştirmesini sağlar.
  • Maps Platform Datasets Viewer rolü, projedeki veri kümelerine salt okuma erişimi verir. Bu rol, bir veri kümesi üzerinde listeleme, alma veya indirme işlemi gerçekleştirmenizi sağlar.

Daha fazla bilgi için Google Cloud konsolunu kullanarak IAM rolü atama başlıklı makaleyi 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.

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

    İstekte bulunan 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 erişimini 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 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 bayt ile temsil edilebilir).
  • Açıklamaların boyutu 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.

Veri hazırlamayla ilgili en iyi uygulamalar

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

Verilerinizi hazırlamaya yönelik en iyi uygulamalardan bazıları şunlardır:

  1. Özellik özelliklerini en aza indirin. Yalnızca haritanızın stilini belirlemek 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 bir özelliğe ek özellikler birleştirebilirsiniz. Örneğin, bkz. Veriye dayalı stil ile verilerinizi gerçek zamanlı olarak görme.
  2. Mümkün olduğunda karo boyutunu en aza indirmek ve harita performansını iyileştirmek amacıyla tam sayı gibi mülk nesneleri için basit veri türleri kullanın.
  3. Bir dosyayı yüklemeden önce karmaşık geometrileri basitleştirin. Bu işlemi, açık kaynak Mapshaper.org yardımcı programı gibi seçtiğiniz bir coğrafi araçla veya karmaşık poligon geometrilerinde ST_Simplify kullanarak BigQuery'de 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 seçtiğiniz bir coğrafi araçla veya yoğun nokta geometrilerinde ST_CLUSTERDBSCAN kullanarak BigQuery'de yapabilirsiniz.

Veri kümesi en iyi uygulamaları hakkında daha fazla bilgi için Veri kümeleri ve BigQuery ile verilerinizi görselleştirme bölümüne bakın.

GeoJSON gereksinimleri

iOS için Haritalar SDK'sı, mevcut GeoJSON spesifikasyonunu desteklemektedir. iOS için Haritalar SDK'sı, aşağıdaki nesne türlerinden herhangi birini içeren GeoJSON dosyalarını da destekler:

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

iOS için Haritalar SDK'sı, 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

iOS için Haritalar SDK'sı aşağıdaki şartlara sahiptir:

  • Tüm URL'ler dosyanın kendisine yerel (veya ilgili) 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>.
  • Ağ bağlantıları (ör. <NetworkLink>)
  • <GroundOverlay> gibi zemin bindirmeleri
  • 3D geometriler veya <altitudeMode> gibi rakımla ilgili etiketler
  • <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
  • 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 bir önceliğe sahip olduğu için x ve y sütunlarındaki değerler kullanılır ve wkt sütunu yok sayı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 bunlar herhangi bir sırada gerçekleşebilir.

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ı

Yaygın 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ı

Yaygın KML hataları şunlardır:

  • Veri dosyası, yukarıda listelenen desteklenmeyen KML özelliklerinden hiçbirini içermemelidir. Aksi takdirde, verilerin içe aktarılması 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. Bir 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)
  • Geometri sütunlarınız x ve y ise birimlerin enlem ve boylam olduğundan emin olun. Bazı herkese açık veri kümeleri, x ve y başlıkları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ümesinin adını girin. Ad, tüm veri kümelerinde benzersiz olmalıdır.
  4. İsteğe bağlı olarak 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ü, yani 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 Browse'u (Göz at) tıklayıp 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. Create'i (Oluştur) 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ılı bir veri kümesi oluşturduktan sonra durumu Tamamlandı olarak görünür. Ardından, veri kümesinin ayrıntılarını inceleyebilirsiniz.

Veri kümesini görüntülemek veya değiştirmek 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 harita üzerinde görmek için Önizleme sekmesini tıklayın.
    3. Veri kümesinin tüm özelliklerini görmek için Tablo Verileri sekmesini tıklayın. Bunlar, haritadaki veri kümesini biçimlendirmek 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 veriler yüklemek için Veri Dosyasını İçe Aktar düğmesini tıklayın.

      Veri kümesine yeni veriler yüklendiğinde 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üm olur.

      Yüklemede bir hata varsa:

      • Yeni veri kümesi sürümünün durumu TAMAMLANDI dışında bir duruma ayarlandı. Örneğin, daha önce "etkin" bir sürüm varsa veri kümesinin durumu REVERTED olarak ayarlanır.
      • Daha önce "etkin" durumda 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.