Veri kümesi oluşturma ve yönetme

Platform seçin: Android iOS JavaScript

Veri kümeleri, coğrafi verileri yerel bir dosyadan veya Google Cloud Storage'dan Google Haritalar Platformu. Daha sonra, veri kümesini bir veya daha fazla harita stiliyle Cloud Console'da görüntüleyebilirsiniz. Veri kümesini bir harita stiliyle ilişkilendirdikten sonra, dinamik olarak harita uygulamanızın stilini belirlemek için veriye dayalı stil API'sı.

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 adlı makaleyi inceleyin.

Rolleri yapılandırma

Bir Google Cloud projesinde veri kümeleri oluşturmak ve yönetmek için Sahip veya Düzenleyici IAM rolü belirlemenize yardımcı olur.

Alternatif olarak aşağıdaki IAM rollerini bir kullanıcı hesabına atayabilir veya kullanacağınız bir hizmet hesabı oluşturun:

  • Maps Platform Datasets Admin rolü, kullanıcı veya hizmet hesabına izin verir projedeki veri kümelerine okuma/yazma erişimi sağlar. Bu rol, kullanıcının tüm işlemleri gerçekleştirebilmesini sağlar veri kümesi üzerinde çalışıyor.
  • Maps Platform Datasets Viewer rolü salt okuma erişimi verir veri kümelerine dönüştürebilir. Bu rol sayesinde liste alabilir, alabilir veya indirebilirsiniz işlem olduğunu unutmayın.

Daha fazla bilgi için bkz. Google Cloud konsolunu kullanarak IAM rolü verin.

Bir veri kümesinin veri kaynağı

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

  • Cloud Storage'dan veri yüklerken Cloud Storage'daki verilere erişebilir. Bu yol, gs://GCS_BUCKET/FILE

    İstekte bulunan kullanıcı için Storage Nesne Görüntüleyici gereklidir. rolü veya storage.objects.get iznini içeren başka bir rol. Örneğin, Cloud Storage'a erişimi yönetme hakkında daha fazla bilgi için bkz. Erişim denetimine genel bakış.

  • Yerel bir dosyadan veri yüklerken GeoJSON, KML veya CSV dosyasının yolunu belirtin ekleyebilirsiniz.

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

Veri yüklerken:

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

Veri hazırlamayla ilgili en iyi uygulamalar

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

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

  1. Özellik özelliklerini en aza indirin. Yalnızca stil belirlemek için gereken özellik özelliklerini koru haritanız (ör. "id") ve "category". Bir istemcideki özelliğin ek mülklerini ekleyebilirsiniz benzersiz tanımlayıcı anahtarında veriye dayalı stiller kullanan bir uygulamadır. Örneğin, bkz. Veriye dayalı stil ile verilerinizi gerçek zamanlı olarak görün.
  2. Mümkün olduğunda tamsayılar, kullanarak karo boyutunu küçültün ve harita performansını artırın.
  3. Bir dosya yüklemeden önce karmaşık geometrileri basitleştirin. Bu işlemi seçtiğiniz jeo-uzamsal araç (ör. açık kaynak Mapshaper.org yardımcı programını kullanarak veya ST_Simplify geometrik şekiller ve grafiklerdir.
  4. Bir dosya yüklemeden önce çok yoğun noktaları kümeleyin. Bu işlemi seçtiğiniz jeo-uzamsal araç (ör. açık kaynak turf.js küme işlevleri olarak veya BigQuery'de ST_CLUSTERDBSCAN kullanılarak GeoX çalışması yapmaya karar verdi.

Veri kümeleriyle ilgili en iyi uygulamalar hakkında daha fazla bilgi için Veri kümeleri ve BigQuery ile verilerinizi görselleştirin.

GeoJSON gereksinimleri

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

  • Geometri nesneleri. Geometri nesnesi, birleşim olarak tanımlanan mekansal bir şekildir noktaların, çizgilerin ve poligonların sayısını gösterir.
  • Nesneleri öne çıkarın. Özellik nesnesi bir geometri ve buna ek olarak (anlamı uygulamaya özgü olan ad/değer çiftleri).
  • Özellik koleksiyonları. Özellik koleksiyonu, özellik nesnelerinden oluşan bir gruptur.

Android için Haritalar SDK'sı, koordinat referans sisteminde veri içeren GeoJSON dosyalarını desteklemez WGS84 dışında (CRS) kullanmayın.

GeoJSON hakkında daha fazla bilgi için bkz. RFC 7946 uyumlu.

KML gereksinimleri

Android için Haritalar SDK'sı 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>.
  • Ağ bağlantıları, ör. <NetworkLink>
  • <GroundOverlay> gibi zemin bindirmeler
  • 3D geometriler veya <altitudeMode> gibi rakımla ilgili etiketler
  • Kamera özellikleri (ör. <LookAt>)
  • KML dosyasında tanımlanan stiller.

CSV koşulları

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, örneğin 1600 Amphitheatre Parkway Mountain View, CA 94043

Örneğin, dosyanız x, y ve wkt adlı sütunlar içeriyor. x ve y, tarama sırasına göre daha yüksek bir önceliğe sahip olduğu için desteklenen sütun adları şunlardır: 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. Diğer bir deyişle, Hem x hem de y koordinat verilerini içeren xy. x ve y koordinatlarının içinde olmalıdır ayrı sütunlar oluşturabilirsiniz.
  • 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ı herhangi bir sırada olabilir.

Veri yükleme hatalarını işleme

Bir veri kümesine veri yüklerken, bu makalede açıklanan yaygın hatalardan biriyle karşılaşabilirsiniz: bölümüne bakın.

GeoJSON hataları

Yaygın GeoJSON hataları şunlardır:

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

KML hataları

Yaygın KML hataları şunlardır:

  • 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 bir geometri sütunu için değer eksik. CSV dosyasındaki tüm satırlar şunları içermelidir: boş olmayan değerleri girin. 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, örneğin 1600 Amphitheatre Parkway Mountain View, CA 94043
  • Geometri sütunlarınız x ve y ise birimlerin boylam ve enlem. Bazı herkese açık veri kümeleri, başlıkların altında farklı koordinat sistemleri kullanır. x ve y. Yanlış birimler kullanılırsa veri kümesi içe aktarılabilir başarılı bir şekilde çalışır, ancak oluşturulan veriler beklenmedik konumlardaki veri kümesi noktalarını 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. Bu ad, tüm veri kümelerinde 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 aktarma sayfası görüntülenir.
  6. Veri kümesini farklı bir şekilde doldurmak için kullanılan verilerin Yükleme kaynağını seçin Masaüstü: Sisteminizdeki yerel bir dosya veya Google Cloud Storage paketi.
    • Masaüstü için Göz at'ı tıklayın ve ardından şu kaynaktan dosyayı seçin: dosya seçici gibi.
    • Google Cloud Storage paketi için Göz at'ı tıklayıp seçin. verileri içeren paket ve dosyadır.
  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. Veri kümeleri sayfası yeni verilerinizi gösteren veri kümesiyle eşleştirilir. Durum İşleniyor olmalıdır.

    Veriler başarıyla yüklenirse:

    • Veri kümesinin durumu TAMAMLANDI olarak ayarlanır.
    • Veri kümesi "etkin" hale gelir sürümü ve uygulamanız tarafından kullanılan sürümdür.

    Yükleme işleminde hata varsa:

    • Yeni veri kümesi sürümünün durumu şundan farklı bir duruma ayarlandı: TAMAMLANDI.

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

Bir veri kümesi oluşturduktan sonra 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üntülenir.
    1. Veri kümesiyle ilgili bilgileri görmek için Ayrıntılar sekmesini tıklayın. Bu sekmede Ayrıca, veri kümesi adını ve açıklamasını düzenleyebilirsiniz.
    2. Veri kümenizi harita üzerinde görmek için Önizleme sekmesini tıklayın ( durumu TAMAMLANDI veya GERİ ALINDI şeklindedir.
    3. Veri kümesinin tüm özelliklerini (veri kümeleri) görmek için Tablo Verileri sekmesini tıklayın durumu TAMAMLANDI veya GERİ ALINDI şeklindedir. Bunlar: harita üzerinde veri kümesinin stilini belirlemek için kullanabileceğiniz özellikler.
    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. Yeni verileri veri kümesine 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üklendi:

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

      Yükleme işleminde hata varsa:

      • Yeni veri kümesi sürümünün durumu şundan farklı bir duruma ayarlandı: TAMAMLANDI. Örneğin, önceden tanımlanmış bir "etkin" sürümü, veri kümesinin durumu GERİ ALINDI olarak ayarlanır.
      • Daha önce "etkin" olan veri kümesi sürümü "etkin" olarak kalır ve sürümü) kullandığınızdan emin olun.