Java JAK API ile Google KML Kullanımı

Batuhan Düzgün tarafından yayınlanmıştır 2. December 2012 08:11

Herkese merhaba arkadaşlar, uzun bir aranın ardından yeni bir makale hazırlama fırsatı yakalayabildim.   Bu makale konusunda Coğrafi Bilgi Sistemleri içerisinde yer alan bir konudan bahsedeceğim. Google firmasının ortaya çıkarmış olduğu XML tabanlı bir teknoloji olan KML'den bahsedeceğim.

KML nedir ?

Coğrafi bilgi sistemlerinde haritalar önemlidir. Yeryüzünün havadan çekilmiş fotoğrafları Raster (Altlık) olarak nitelendirilir. Bu altlıklar harita yayını olarak internet üzerinden yayınlanır.  Bu fotoğraflar servisler üzerinden yayına açılır. Bu yayını yapan Server yazılımları aynı zamanda Geometri Servisi, GeoData Servisi vb …  yayınlarıda gerçekleştirirler. Bu yazılımlar ArcGIS ServerGeoServer gibi  yazılımlardır.

Yayına sunulmuş olan harita üzerinde Graphic katmanı yaratılır ve bu katman üzerinde çeşitli çizimler yapılabilir. Örneğin: Polygon, polyline, point ve line gibi çizimler yapılabilir. Yayına sunulmuş olan harita üzerine uygun projeksiyon  ile çizilmiş çeşitli katmanlar bulunabilir. Örneğin : Bir şehre ait Elektrik ve Gaz verilerini coğrafi olarak gösteren binalar, hatlar, servis kutuları ve vana gibi bileşenler katmanlar halinde harita üzerine konumlandırılır. Örneğin, eğerki projeksiyon uygun verilmemişse Akhisar için çizilmiş olan bina katmanı dünyanın öbür ucunda farklı bir lokasyonda görülebilir. Katmanların üst üste düzgün bir biçimde konumlanması gerekir. Graphic katmanında da yapılan çizimler belli noktalar kümesidir ve belli bir lokasyonda bulunur.

Yapılan her türlü çizimi coğrafi bir bilgi olarak export edip başka yerlerde kullanmak üzere hazırlanmış olan yapı KML'dir.  KML coğrafi nesnelere ait bilgileri XML tabanlı bir yapıda sunar. Örneğin aşağıda basit olarak bir kaç tane KML örneği verilmiştir.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?><kml xmlns="http://www.opengis.net/kml/2.2" xmlns:ns2="http://www.google.com/kml/ext/2.2" xmlns:ns3="http://www.w3.org/2005/Atom" xmlns:ns4="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0">

       <!-- Placemark etiketi çizilmiş olan geometrik nesnenin konumuyla ve sözel verileriyle ilgili bilgileri tutar. -->      

       <Placemark>

             <!-- Coğrafi olarak belirtilmiş olan geometri nesnesinin isim bilgisini tutar -->

             <name>Ornek Veri</name>

             <!-- Coğrafi olarak belirtilmiş olan geometri nesnesinin tanımlama bilgileri tutulur. -->

             <description>

             Tanımlama Bilgileri bu kısımdadır.

             </description>

             <!-- Coğrafi bir nesnenin hangi tipte olduğu belirtilir. Point, PolyLine veya Polygon şeklinde temelde üç tip vardır. -->

             <Point>

                    <coordinates>45.3343433,34.2323423223 44.3323223,34.0,2.3232433E7 32.26262,45.24233</coordinates>

             </Point>

       </Placemark>

</kml>

JAK API Nedir?

JAK API, Java diliyle geliştirilmiş olan KML API' sidir. Bu API vasıtasıyla birlikte KML dosyaları oluşturulabilir, KML dosyaları açılabilir ve KML dosyaları güncellenip yeniden kaydedilebilir. Bu yazıda sizlerle birlikte JAK API'yi kullanıyor olacağız. JAK API’yi http://code.google.com/p/javaapiforkml/downloads/list linkinden indirebilirsiniz.

 

Placemark ve Point  Oluşturulması

Bu örnekte Placemark nesnesi yaratıp, Point ile ilgili hem coğrafi bilgiler, hemde sözel veriler bir arada tutulacaktır. Placemark nesnesi bünyesinde Point, Line, Polygon gibi coğrafi nesneleri tutabilir. Aynı zamanda o konumla ilgili sözel verileride tutabilir.

package main;

import java.io.File;

import java.io.FileNotFoundException;

import javax.xml.bind.JAXBContext;

import javax.xml.bind.JAXBException;

import javax.xml.bind.Marshaller;

import de.micromata.opengis.kml.v_2_2_0.*;

public class Main {

       public static void main(String[] args) throws FileNotFoundException {            

             // Yeni bir KML içeriği yaratılır. Yani Kml etiketi oluşturulur.

             Kml kml = KmlFactory.createKml();

             // Yeni bir "Placemark" oluşturulur.

             Placemark placemark = KmlFactory.createPlacemark();

             // Harita üzerine yerleştirilecek olan "Placemark" ismi setlenir.

             placemark.setName("İş Yeri Adresi");

             // Harita üzerine yerleştirilecek olan "Placemark" adresi setlenir.

             placemark.setAddress("Atatürk Mahallesi, Cumhuriyet Sokak No : 1923 İstanbul / Türkiye");

             // Harita üzerine yerleştirilecek olan "Placemark" tanım bilgileri setlenir.

             placemark.setDescription("İş yeri adresi ile ilgili detaylardır.");

             // Harita üzerine yerleştirilecek olan "Placemark" üzerine telefon bilgisi setlenir.

             placemark.setPhoneNumber("+90504444423");

            

             // Harita üzerine yerleştirilecek olan "Point" nesnesi oluşturulur.

             // Placemark içinde Point, Line, Polygon gibi coğrafi nesneleri tuttuğu gibi,

             // Bu lokasyonla ilgili sözel verileride tutar.

             Point point = KmlFactory.createPoint();

             // Point nesnesinin koordinat bilgisi setlenir.

             point.getCoordinates().add(new Coordinate(45.231413, 43.2322332));

             // Geometrik harita nesnesi olan Point, Placemark üzerine setlenir.

             placemark.setGeometry(point);

             kml.setFeature(placemark);

            

             JAXBContext jc = null;

             try {

                    jc = JAXBContext.newInstance(Kml.class);

                    // Hazırlanmış olan KML içeriği KML dosyasına dönüştürülür.

                    Marshaller m = jc.createMarshaller();

                    m.marshal(kml, new File("/home/batuhan/IsyeriAdresi.kml"));

             }

             catch (JAXBException e) {e.printStackTrace();}       

       }

}

Placemark ve Line Oluşturulması

Bu örnekte Placemark üzerinde Line nesnesi oluşturulacaktır. Line nesnesi gaz hattı üzerinde çizim yapıldığı şeklinde bir senaryo kurgulanacaktır.

package main;

import java.io.File;

import java.io.FileNotFoundException;

import javax.xml.bind.JAXBContext;

import javax.xml.bind.JAXBException;

import javax.xml.bind.Marshaller;

import de.micromata.opengis.kml.v_2_2_0.*;

public class Main {

       public static void main(String[] args) throws FileNotFoundException {

             // Yeni bir KML içeriği yaratılır. Yani Kml etiketi oluşturulur.

             Kml kml = KmlFactory.createKml();

             // Yeni bir "Placemark" oluşturulur.

             Placemark placemark = KmlFactory.createPlacemark();

             // Harita üzerine yerleştirilecek olan "Placemark" ismi setlenir.

             placemark.setName("Gaz Hattı");

             // Harita üzerine yerleştirilecek olan "Placemark" adresi setlenir.

             placemark.setAddress("Reşatbey Mahallesi, Cumhuriyet Sokak No : 19 Akhisar / Türkiye");

             // Harita üzerine yerleştirilecek olan "Placemark" tanım bilgileri setlenir.

             placemark.setDescription("Mahalle üzerindeki hatların kontrolü yapıldı.");

             // Harita üzerine yerleştirilecek olan "Placemark" üzerine telefon bilgisi setlenir.

             placemark.setPhoneNumber("+90504444423");

            

             // Harita üzerinde yer alacak olan Line geometrisi oluşturulur ve gerekli koordinat bilgisi setlenir.

             LineString line = KmlFactory.createLineString();

             line.getCoordinates().add(new Coordinate(45.242342, 44.3223211));

             line.getCoordinates().add(new Coordinate(48.242342, 43.2435211));

             line.getCoordinates().add(new Coordinate(49.242342, 47.225211));

             placemark.setGeometry(line);

             kml.setFeature(placemark);

            

             JAXBContext jc = null;

             try {

                    jc = JAXBContext.newInstance(Kml.class);

                    // Hazırlanmış olan KML içeriği KML dosyasına dönüştürülür.

                    Marshaller m = jc.createMarshaller();

                    m.marshal(kml, new File("/home/batuhan/GazHatti.kml"));

             }

             catch (JAXBException e) {e.printStackTrace();}       

       }

}

Her iki kaynak kodu derledikten sonra aşağıdaki gibi iki tane KML dosyası oluşturulacaktır. Hemen ardından https://maps.google.com/  linkine giderek demo bir harita yayını oluşturulacaktır. Aşağıdaki adımları takip ederek demo harita yayınını oluşturulmalıdır.  

İlk adım olarak Google Map üzerinden demo yayını açabilmek için aşağıdaki gibi harita oluşturulur.


Daha sonra harita başlığı ve tanımlama bilgileri girilir ve harita oluşturulur.

 

 
Oluşturulmuş olan KML dosyaları sırasıyla eklenir. Bunun için “içer aktar” tuşuna tıklanır ve KML dosyası yüklenir.
 
 
 
KML dosyaları aşağıdaki gibi Upload edilir.
 
 
 
 
 
Yükleme işlemlerinden sonra harita görünümü aşağıdaki gibidir.
 
 
 
 
 

KML dosyaların oluşturulması ve Google Map üzerine import edilmesiyle ilgili anlatacaklarım şimdilik bundan ibarettir. Bir sonraki makalemde görüşmek dileğiyle …

Batuhan Düzgün

Bilgisayar Mühendisi

Endüstri Mühendisi 

Be the first to rate this post

  • Currently 0/5 Stars.
  • 1
  • 2
  • 3
  • 4
  • 5

Etiketler:

Java

Comments

Add comment


(Will show your Gravatar icon)  

  Country flag

biuquote
  • Comment
  • Preview
Loading





Bu site BlogEngine.NET 1.4.5.0 ile oluşturulmuştur. Türkçe çevirisi BlogEngine TR ekibi tarafından yapılmıştır.

Batuhan Düzgün

Sakarya Üniversitesi 

Bilgisayar Mühendisi

Endüstri Mühendisi

Yeditepe Üniversitesi

Bilgisayar Mühendisliği Yüksek Lisans 

 sahibinden.com

   Kıdemli Uzman Yazılım Mühendisi  

E-Mail 

   batuhan.duzgun@sahibinden.com

   batuhan.duzgun@windowslive.com

  github.com/batux

 

Sayfalar

Calendar

<<  August 2019  >>
MoTuWeThFrSaSu
2930311234
567891011
12131415161718
19202122232425
2627282930311
2345678

Yazıları geniş takvimde göster