Veri kümeleri, yerel bir dosyadan veya Google Cloud Storage'dan Google Haritalar Platformu'na coğrafi veriler yüklemenizi sağlar. Ardından, Cloud Console'da bir veri kümesini bir veya daha fazla harita stiliyle ilişkilendirebilirsiniz. Veri kümesini bir harita stiliyle ilişkilendirdikten sonra, harita uygulamanızı dinamik olarak stillendirmek için veri odaklı stil API'sini kullanın.
Coğrafi verilerinizi bir veri kümesine yüklemek için REST API'yi de kullanabilirsiniz. Daha fazla bilgi için Maps Datasets API'ye 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.
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ıya veya hizmet hesabına projedeki veri kümelerine okuma/yazma erişimi verir. Bu rol, kullanıcının bir veri kümesi üzerinde 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 listeleme, alma veya indirme işlemi yapmanıza olanak tanır.
Daha fazla bilgi için Google Cloud Console'u kullanarak IAM rolü verme başlıklı makaleyi inceleyin.
Veri kümesi için 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.İsteği gönderen kullanıcının Depolama Nesnesi 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ış başlıklı makaleyi 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 projenizde benzersiz olmalıdır.
- Görünen adlar 64 bayttan kısa olmalıdır (Bu karakterler UTF-8'de temsil edildiğinden bazı dillerde her karakter birden fazla baytla temsil edilebilir).
- Açıklamalar 1.000 bayttan kısa olmalıdır.
Veri yüklerken:
- Desteklenen dosya türleri CSV, GeoJSON ve KML'dir.
- Desteklenen maksimum dosya boyutu 500 MB'tır.
- Özellik sütunu adları "?_" dizesiyle başlayamaz.
- Üç boyutlu geometriler desteklenmez. Bu, WKT biçimindeki "Z" sonekini ve GeoJSON biçimindeki yükseklik koordinatını içerir.
Veri hazırlamayla ilgili en iyi uygulamalar
Kaynak verileriniz karmaşık veya büyükse (ör. yoğun noktalar, uzun çizgi dizeleri ya da poligonlar) (genellikle 50 MB'tan büyük kaynak dosyalar bu kategoriye girer) görsel haritada en iyi performansı elde etmek için yüklemeden önce verilerinizi basitleştirmeyi deneyin.
Verilerinizi hazırlarken dikkat etmeniz gereken bazı en iyi uygulamaları aşağıda bulabilirsiniz:
- Özelliklerin özelliklerini en aza indirin. Haritanızı şekillendirmek 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 özelliğe ek özellikler ekleyebilirsiniz. Örneğin, Veriye dayalı stil ile verilerinizi anlık olarak görme başlıklı makaleyi inceleyin.
- Döşeme boyutunu en aza indirmek ve harita performansını artırmak için mümkün olduğunda tesis nesnelerinde basit veri türlerini (ör. tam sayılar) kullanın.
- 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 BigQuery'de ST_Simplify kullanarak karmaşık poligon geometrilerinde yapabilirsiniz.
- Dosyayı yüklemeden önce çok yoğun noktaları kümeleyin. Bu işlemi, açık kaynaklı turf.js küme işlevleri gibi tercih ettiğiniz bir coğrafi araçta veya BigQuery'de yoğun nokta geometrileri üzerinde ST_CLUSTERDBSCAN kullanarak yapabilirsiniz.
Veri kümeleriyle ilgili en iyi uygulamalar hakkında ek bilgiler için Verilerinizi veri kümeleri ve BigQuery ile görselleştirme başlıklı makaleyi inceleyin.
GeoJSON gereksinimleri
iOS için Haritalar SDK'sı, mevcut GeoJSON spesifikasyonunu destekler. 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, isteğe bağlı deliklere sahip noktaların, çizgilerin ve poligonların birleşimi olarak tanımlanan bir uzamsal şekildir.
- Özellik nesneleri. Bir özellik nesnesi, bir geometri ile anlamı uygulamaya özgü olan ek ad/değer çiftlerini içerir.
- Özellik koleksiyonları. Özellik koleksiyonu, bir dizi özellik nesnesidir.
iOS için Haritalar SDK'sı, 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 koşulları
iOS için Haritalar SDK'sının aşağıdaki koşulları karşılaması gerekir:
- Tüm URL'ler dosyanın kendisiyle ilgili yerel (veya göreli) URL'ler olmalıdır.
- Nokta, çizgi ve poligon geometrileri desteklenir.
- Tüm veri özellikleri dize olarak kabul edilir.
- Dosyanın dışında tanımlanan simgeler veya
<styleUrl>
. <NetworkLink>
gibi ağ bağlantıları<GroundOverlay>
gibi zemin bindirmeler- 3D geometriler veya
<altitudeMode>
gibi yükseklikle ilgili etiketler <LookAt>
gibi kamera özellikleri- KML dosyasında 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
(Well-Known Text)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ızda x
, y
ve wkt
adlı sütunlar var.
x
ve y
, yukarıdaki listede desteklenen sütun adlarının sırasına göre daha yüksek ö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ızda
lat
velong
sütunları varsa bunlar herhangi bir sırada olabilir.
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ı
Sık karşılaşılan GeoJSON hataları şunlardır:
type
alanı eksik veyatype
bir dize değil. Yüklenen GeoJSON veri dosyası, her Feature nesnesi ve Geometry nesnesi tanımının bir parçası olaraktype
adlı bir dize alanı içermelidir.
KML hataları
Sık karşılaşılan 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ütununun değerleri 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
x
vey
, geometri sütunlarınızsa birimlerin boylam ve enlem 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, veri kümesi noktalarını beklenmedik konumlarda 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. Ad, tüm veri kümeleri arasında benzersiz olmalıdır.
- İsteğe bağlı olarak bir veri kümesi Açıklaması girin.
- Devam'ı tıklayın. Verileri içe aktar sayfası gösterilir.
- 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ü için 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ın ve verileri içeren paketi ve dosyayı seçin.
- Dosya biçimini seçin.
- Ayarlarınızı incelemek için Devam'ı tıklayın.
Oluştur'u tıklayın. Yeni veri kümenizin gösterildiği Veri Kümeleri sayfası açılır. Durum İşleniyor olmalıdır.
Veriler başarıyla yüklenirse:
- Veri kümesinin durumu TAMAMLANDI olarak ayarlanmış olmalıdır.
- Veri kümesi "etkin" sürüm haline gelir ve uygulamanız tarafından kullanılan sürüm olur.
Yükleme sırasında hata oluşursa:
- Yeni veri kümesi sürümünün durumu, COMPLETED (TAMAMLANDI) dışında bir duruma ayarlanmış olmalıdır.
Veri kümesini görüntüleme veya değiştirme
Veri kümesi oluşturduktan sonra veri kümesini görüntüleyebilir veya değiştirebilirsiniz:
- 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österilir.
- 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 haritada görmek için Önizleme sekmesini tıklayın (yalnızca TAMAMLANDI veya GERİ ALINDI durumundaki veri kümeleri).
- Veri kümesinin tüm özelliklerini (yalnızca durumu COMPLETED veya REVERTED olan veri kümeleri) görmek için Tablo Verileri sekmesini tıklayın. Bunlar, haritadaki veri kümesine stil vermek 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.
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üklemek, veri kümesinin yeni bir sürümünü oluşturur. 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 haline gelir ve uygulamanız tarafından kullanılan sürüm olur.
Yükleme sırasında hata oluşursa:
- Yeni veri kümesi sürümünün durumu, COMPLETED (TAMAMLANDI) dışında bir duruma ayarlanmış olmalıdır. Örneğin, önceki bir "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 tarafından kullanılan sürümdür.