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 bir harita stiliyle ilişkilendirdikten sonra harita uygulamanızın stilini dinamik olarak ayarlamak 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 konusuna bakın.
Rolleri yapılandırma
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.
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ümesi üzerinde tüm işlemleri gerçekleştirebilmesini sağlar.Maps Platform Datasets Viewer
rolü, projedeki veri kümelerine salt okuma erişimi verir. Bu rol, bir veri kümesinde listeleme, alma veya indirme işlemi gerçekleştirmenize olanak tanır.
Daha fazla bilgi için Google Cloud konsolunu kullanarak IAM rolü atama başlıklı makaleyi inceleyin.
Bir veri kümesinin veri kaynağı
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ğın 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 ihtiyacı vardır. Cloud Storage'a erişimi yönetme hakkında daha fazla bilgi için Erişim denetimine genel bakış sayfasına göz atın.- 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üçük olmalıdır (Bu karakterler UTF-8'de temsil edildiği için bazı dillerde her karakter birden fazla 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.
- Desteklenen maksimum dosya boyutu 350 MB'tır.
- Özellik sütunu adları "?_" dizesiyle başlayamaz.
- Üç boyutlu geometriler desteklenmez. Buna, WKT biçimindeki "Z" son eki ve GeoJSON biçimindeki rakım koordinatı dahildir.
Veri hazırlamayla ilgili en iyi uygulamalar
Yoğun noktalar, uzun çizgi dizeleri veya poligonlar (genellikle 50 MB'tan büyük kaynak dosya boyutları bu kategoriye girer) gibi kaynak verileriniz karmaşık veya büyükse görsel bir haritada en iyi performansı elde etmek için yükleme işleminden önce verilerinizi basitleştirmeyi düşünün.
Verilerinizi hazırlamaya yönelik en iyi uygulamalardan bazıları şunlardır:
- Özellik özelliklerini en aza indirin. Yalnızca haritanızın stilini belirlemek için gerekli olan "id" ve "category" gibi özellik özelliklerini koruyun. Benzersiz tanımlayıcı anahtarında veriye dayalı stilleri kullanarak istemci uygulamasındaki bir özelliğe ek özellikler ekleyebilirsiniz. Örneğin, Veriye dayalı stil ile verilerinizi gerçek zamanlı olarak görme konusuna bakın.
- Karo boyutunu en aza indirmek ve harita performansını iyileştirmek amacıyla, mümkün olduğunda tamsayı gibi mülk nesneleri için basit veri türlerini kullanın.
- Bir dosya yüklemeden önce karmaşık geometrileri basitleştirin. Bu işlemi, açık kaynaklı Mapshaper.org yardımcı programı gibi istediğiniz bir coğrafi araçta veya karmaşık poligon geometrileri üzerinde ST_Simplify kullanarak BigQuery'de yapabilirsiniz.
- Bir dosya yüklemeden önce çok yoğun noktaları kümeleyin. Bu işlemi açık kaynaklı turf.js küme işlevleri gibi istediğiniz coğrafi bir araçta veya yoğun nokta geometrileri üzerinde ST_CLUSTERDBSCAN kullanarak BigQuery'de yapabilirsiniz.
Veri kümeleri ve BigQuery ile verilerinizi görselleştirme bölümünde, veri kümeleriyle ilgili en iyi uygulamalar hakkında daha fazla bilgi bulabilirsiniz.
GeoJSON gereksinimleri
Maps JavaScript API, geçerli GeoJSON spesifikasyonunu destekler. Maps JavaScript API, 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ı deliklerle birleşimi olarak tanımlanan mekansal bir şekildir.
- Nesneleri öne çıkarın. Özellik nesnesi, bir geometri ve ek ad/değer çiftleri içerir. Bu çiftlerin anlamı, uygulamaya özgüdür.
- Özellik koleksiyonları. Özellik koleksiyonu, özellik nesnelerinden oluşan bir gruptur.
Maps JavaScript API, WGS84 dışında bir koordinat referans sisteminde (CRS) verileri olan 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.
- 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 (ör.
1600 Amphitheatre Parkway Mountain View, CA 94043
)
Ö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 ö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 de y koordinat verilerini içeren
xy
adlı bir sütununuz olamaz. x ve y koordinatları ayrı sütunlarda yer almalı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
velong
sütunları içeriyorsa bunlar herhangi bir sırada olabilir.
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 veyatype
bir dize değil. Yüklenen GeoJSON veri dosyası, her bir özellik nesnesi ve Geometri nesne tanımının parçası olaraktype
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, verileri 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. 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
vey
ise birimlerin boylam ve enlem biçiminde olduğundan emin olun. Bazı herkese açık veri kümeleri,x
vey
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 beklenmedik konumlardaki veri kümesi noktalarını gösterebilir.
Veri kümesi oluşturma
Veri kümesi oluşturmak için:
- Google Cloud Console'da Veri kümeleri sayfasına gidin.
- Veri Kümesi Oluştur'u tıklayın.
- Veri kümesi adını girin. Bu ad, tüm veri kümelerinde benzersiz olmalıdır.
- İsteğe bağlı olarak bir veri kümesi Açıklama girin.
- Devam'ı tıklayın. Verileri içe aktarma sayfası görüntülenir.
- 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 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.
- Dosya biçimi'ni seçin.
- Ayarlarınızı incelemek için Devam'ı tıklayın.
- 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.
- Veri kümenizin durumu Tamamlandı olana kadar bekleyin.
Veri kümesini görüntüleme veya değiştirme
Başarılı bir şekilde oluşturulan veri kümesinin durumu Tamamlandı olarak görünür. Daha sonra veri kümesinin ayrıntılarını inceleyebilirsiniz.
Veri kümesini görüntülemek veya değiştirmek için:
- Google Cloud Console'da Veri kümeleri sayfasına gidin.
- Veri kümesinin adını tıklayın. Veri kümesi ayrıntıları sayfası görüntülenir.
- 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.
- Veri kümenizi harita üzerinde görmek için Önizleme sekmesini tıklayın.
- Veri kümesinin tüm özelliklerini görmek için Tablo Verileri sekmesini tıklayın. Bunlar, harita üzerinde veri kümesinin stilini belirlemek için kullanabileceğiniz özelliklerdir.
- Verileri yerel bir dosyaya indirmek için İndir düğmesini tıklayın.
- Veri kümesini silmek için Sil düğmesini tıklayın.
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ü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ükleme işleminde hata varsa:
- Yeni veri kümesi sürümünün durumu, TAMAMLANDI dışında bir duruma ayarlandı. Örneğin, önceki "etkin" sürüm varsa veri kümesinin durumu GERİ ALINDI olarak ayarlanır.
- Daha önce "etkin" olan veri kümesi sürümü, "etkin" sürüm olarak kalır ve uygulamanızın kullandığı sürümdür.