Android platformunda co\u011frafi konum tabanl\u0131 uygulamalar geli\u015ftirirken, kullan\u0131c\u0131lar\u0131n iki nokta aras\u0131nda bir rota \u00e7izebilmesi temel ve s\u0131k\u00e7a kar\u015f\u0131la\u015f\u0131lan bir gereksinimdir. Navigasyon uygulamalar\u0131ndan lojistik \u00e7\u00f6z\u00fcmlerine, seyahat planlama ara\u00e7lar\u0131ndan konum tabanl\u0131 sosyal a\u011flara kadar pek \u00e7ok alanda rota \u00e7izimi, kullan\u0131c\u0131 deneyimini zenginle\u015ftiren kritik bir \u00f6zelliktir. Google Haritalar SDK’s\u0131, Android geli\u015ftiricilerine bu t\u00fcr i\u015flevselli\u011fi uygulamalar\u0131na entegre etme konusunda g\u00fc\u00e7l\u00fc ve esnek bir yap\u0131 sunar. Bu detayl\u0131 teknik makale, Android Google Haritalar \u00fczerinde iki nokta aras\u0131nda nas\u0131l rota \u00e7izilece\u011fini, gerekli bile\u015fenleri, API entegrasyonlar\u0131n\u0131 ve ad\u0131m ad\u0131m uygulama s\u00fcre\u00e7lerini kapsaml\u0131 bir \u015fekilde ele alacakt\u0131r.<\/p>\n
Google Haritalar SDK’s\u0131, Android uygulamalar\u0131na etkile\u015fimli haritalar eklemek i\u00e7in zengin bir API seti sa\u011flar. Ancak, sadece harita g\u00f6stermek yeterli de\u011fildir; kullan\u0131c\u0131lar\u0131n belirli bir hedefe ula\u015fmak i\u00e7in izlemesi gereken yolu g\u00f6rselle\u015ftirmek, uygulaman\u0131z\u0131n de\u011ferini art\u0131r\u0131r. Rota \u00e7izimi i\u015flemi genellikle iki ana bile\u015fenin birle\u015fiminden olu\u015fur: Google Haritalar SDK’s\u0131 (haritay\u0131 g\u00f6stermek ve rotay\u0131 \u00e7izmek i\u00e7in) ve Google Directions API (ba\u015flang\u0131\u00e7 ve biti\u015f noktalar\u0131 aras\u0131nda rota verilerini almak i\u00e7in). Bu iki bile\u015feni do\u011fru bir \u015fekilde entegre etmek, ba\u015far\u0131l\u0131 bir rota \u00e7izim uygulamas\u0131n\u0131n anahtar\u0131d\u0131r.<\/p>\n
Google Haritalar SDK’s\u0131, Android uygulamalar\u0131n\u0131za tamamen \u00f6zelle\u015ftirilebilir haritalar eklemenizi sa\u011flar. Marker’lar, poligonlar, daireler ve \u00e7izgiler (polyline’lar) gibi \u00e7e\u015fitli harita nesneleri eklemenize olanak tan\u0131r. Rota \u00e7izimi i\u00e7in, Directions API’den al\u0131nan rota verilerini bir SDK’y\u0131 kullanmaya ba\u015flamak i\u00e7in \u00f6ncelikle bir Google Cloud projesi olu\u015fturman\u0131z ve Haritalar SDK’s\u0131n\u0131 etkinle\u015ftirmeniz gerekir. Ayr\u0131ca, uygulamalar\u0131n\u0131z\u0131n API’ye g\u00fcvenli bir \u015fekilde eri\u015febilmesi i\u00e7in bir API anahtar\u0131 ( Uygulaman\u0131z\u0131n harita ve konum servislerini kullanabilmesi i\u00e7in belirli izinlere ve ba\u011f\u0131ml\u0131l\u0131klara ihtiyac\u0131 vard\u0131r:<\/p>\n * \u0130nternet Eri\u015fimi<\/strong>: Directions API’ye istek g\u00f6ndermek ve harita d\u00f6\u015femelerini indirmek i\u00e7in * Google Maps Utility Library (Opsiyonel ama \u00d6nerilir)<\/strong>: Directions API’den al\u0131nan poliline kodunu \u00e7\u00f6zmek i\u00e7in \u00e7ok kullan\u0131\u015fl\u0131d\u0131r.<\/p>\n Haritay\u0131 uygulaman\u0131za entegre etmek i\u00e7in iki ana y\u00f6ntem vard\u0131r: * Daha sonra aktivitenizde\/fragment’\u0131n\u0131zda bu fragman\u0131 al\u0131p Her iki durumda da, harita haz\u0131r oldu\u011funda * Kamera Kontrol\u00fc<\/strong>: Do\u011frudan Google Haritalar SDK’s\u0131 ile rota \u00e7izmek m\u00fcmk\u00fcn de\u011fildir; sadece geometrik \u015fekiller (polyline’lar) \u00e7izebilirsiniz. As\u0131l rota verisini elde etmek i\u00e7in Google Directions API’yi kullanman\u0131z gerekir.<\/p>\n Google Directions API, belirli bir ba\u015flang\u0131\u00e7 noktas\u0131 ile bir veya daha fazla hedef nokta aras\u0131nda yol tarifi bilgileri sa\u011flayan bir web servisidir. Bu API’yi kullanarak s\u00fcr\u00fc\u015f, y\u00fcr\u00fcme, bisiklet veya toplu ta\u015f\u0131ma gibi farkl\u0131 ula\u015f\u0131m modlar\u0131 i\u00e7in rota detaylar\u0131n\u0131 alabilirsiniz. API, iste\u011fe ba\u011fl\u0131 ara noktalar\u0131, alternatif rotalar\u0131 ve trafik bilgilerini de destekler.<\/p>\n API’yi kullanabilmek i\u00e7in yine bir Google Cloud projesi ve etkinle\u015ftirilmi\u015f “Directions API” hizmetine sahip olman\u0131z gerekmektedir. Kullan\u0131m limitleri ve \u00fccretlendirme politikalar\u0131n\u0131 Google Cloud dok\u00fcmantasyonundan incelemeniz \u00f6nemlidir.<\/p>\n Directions API’ye yap\u0131lan istekler genellikle bir HTTP GET iste\u011fi \u015feklinde olur ve a\u015fa\u011f\u0131daki temel parametreleri i\u00e7erir:<\/p>\n * \u00d6rnek bir API iste\u011fi URL’si \u015fu \u015fekilde olabilir: Directions API, yan\u0131t\u0131 genellikle JSON format\u0131nda d\u00f6nd\u00fcr\u00fcr. Bu JSON yan\u0131t\u0131, rota bilgilerini i\u00e7eren karma\u015f\u0131k bir yap\u0131ya sahiptir:<\/p>\n * Bu kodlanm\u0131\u015f poliline dizesi, Google’\u0131n kendi algoritmas\u0131yla s\u0131k\u0131\u015ft\u0131r\u0131lm\u0131\u015f bir dizi \u015eimdi, yukar\u0131da bahsedilen bile\u015fenleri bir araya getirerek iki nokta aras\u0131nda rota \u00e7izimi i\u015flemini ad\u0131m ad\u0131m inceleyelim.<\/p>\n Kullan\u0131c\u0131dan ba\u015flang\u0131\u00e7 ve biti\u015f noktalar\u0131n\u0131 alman\u0131n birka\u00e7 yolu vard\u0131r:<\/p>\n * Metin Giri\u015fi (EditText)<\/strong>: Kullan\u0131c\u0131dan adres veya koordinat girmesini isteyebilirsiniz. Bu durumda, girilen adresleri koordinatlara \u00e7evirmek i\u00e7in Google Geocoding API’yi kullanman\u0131z gerekebilir. Bu makalede, Directions API’ye bir HTTP iste\u011fi g\u00f6ndermeniz gerekir. Bu i\u015flemi arka planda bir i\u015f par\u00e7ac\u0131\u011f\u0131nda yapmal\u0131s\u0131n\u0131z, \u00e7\u00fcnk\u00fc a\u011f i\u015flemleri UI i\u015f par\u00e7ac\u0131\u011f\u0131n\u0131 bloke edebilir ve ANR (Application Not Responding) hatalar\u0131na yol a\u00e7abilir.<\/p>\n * Kullan\u0131labilecek K\u00fct\u00fcphaneler<\/strong>: \u00d6rnek olarak, bir URL olu\u015fturup bu URL’ye istek g\u00f6nderen ve yan\u0131t\u0131 okuyan bir metot d\u00fc\u015f\u00fcnebiliriz:<\/p>\n API’den gelen JSON yan\u0131t\u0131n\u0131 ayr\u0131\u015ft\u0131rman\u0131z gerekir. Bu i\u015flem i\u00e7in Android’de yerle\u015fik 1. JSON yan\u0131t\u0131n\u0131 1. Bir Rotan\u0131n ba\u015flang\u0131\u00e7 ve biti\u015f noktalar\u0131n\u0131 g\u00f6rselle\u015ftirmek i\u00e7in haritaya marker’lar eklemek iyi bir uygulamad\u0131r.<\/p>\n 1. Ba\u015flang\u0131\u00e7 noktas\u0131 i\u00e7in bir Rota \u00e7izildikten sonra, harita kameras\u0131n\u0131 t\u00fcm rotay\u0131 g\u00f6sterecek \u015fekilde ayarlamak kullan\u0131c\u0131 deneyimini \u00f6nemli \u00f6l\u00e7\u00fcde iyile\u015ftirir.<\/p>\n 1. Bir Rota \u00e7izimi i\u015flevselli\u011fini daha da geli\u015ftirmek ve uygulaman\u0131z\u0131 optimize etmek i\u00e7in baz\u0131 ileri d\u00fczey konular\u0131 ele alal\u0131m.<\/p>\n Directions API’ye yap\u0131lan istekte Bazen kullan\u0131c\u0131lar ba\u015flang\u0131\u00e7 ve biti\u015f noktalar\u0131 aras\u0131nda belirli duraklardan ge\u00e7mek isteyebilir. * Uygulaman\u0131zda bir se\u00e7im aray\u00fcz\u00fc sunarak kullan\u0131c\u0131n\u0131n istedi\u011fi ula\u015f\u0131m modunu se\u00e7mesine izin verebilirsiniz.<\/p>\n API istekleri ba\u015far\u0131s\u0131z olabilir veya ge\u00e7erli bir rota bulunamayabilir. Bu durumlar\u0131 ele almak \u00f6nemlidir:<\/p>\n * A\u011f Hatalar\u0131<\/strong>: \u0130nternet ba\u011flant\u0131s\u0131 yoksa kullan\u0131c\u0131ya bilgi verin. * Arka Plan \u0130\u015f Par\u00e7ac\u0131klar\u0131<\/strong>: T\u00fcm a\u011f isteklerini ve yo\u011fun JSON ayr\u0131\u015ft\u0131rma i\u015flemlerini ana UI i\u015f par\u00e7ac\u0131\u011f\u0131ndan ay\u0131rarak uygulaman\u0131z\u0131n ak\u0131c\u0131 kalmas\u0131n\u0131 sa\u011flay\u0131n. Daha \u00f6nce bahsetti\u011fimiz * Bu k\u00fct\u00fcphaneleri kullanarak geli\u015ftirme s\u00fcrecinizi h\u0131zland\u0131rabilir ve uygulaman\u0131z\u0131n performans\u0131n\u0131 art\u0131rabilirsiniz.<\/p>\n Geli\u015ftirme s\u00fcrecinde kar\u015f\u0131la\u015fabilece\u011finiz baz\u0131 yayg\u0131n sorunlar ve potansiyel \u00e7\u00f6z\u00fcmleri:<\/p>\n * API Key Hatalar\u0131 ( Android Google Haritalar’da iki nokta aras\u0131nda rota \u00e7izmek, modern mobil uygulamalar\u0131n vazge\u00e7ilmez bir \u00f6zelli\u011fidir. Bu makalede, Google Haritalar SDK’s\u0131 ve Google Directions API’nin entegrasyonuyla bu i\u015flevselli\u011fin nas\u0131l ad\u0131m ad\u0131m uygulanaca\u011f\u0131n\u0131 detayl\u0131 bir \u015fekilde ele ald\u0131k. API anahtar\u0131 kurulumundan, harita entegrasyonuna, Directions API iste\u011fi yap\u0131s\u0131ndan JSON yan\u0131t\u0131n\u0131 ayr\u0131\u015ft\u0131rmaya ve polilineyi haritaya \u00e7izmeye kadar t\u00fcm s\u00fcre\u00e7leri kapsad\u0131k. Ayr\u0131ca, alternatif rotalar, ara noktalar, farkl\u0131 ula\u015f\u0131m modlar\u0131, hata y\u00f6netimi ve performans optimizasyonu gibi geli\u015fmi\u015f konulara da de\u011findik.<\/p>\n Bu rehberi takip ederek, uygulaman\u0131za g\u00fc\u00e7l\u00fc ve kullan\u0131c\u0131 dostu bir rota \u00e7izim \u00f6zelli\u011fi ekleyebilirsiniz. Unutmay\u0131n ki Google API’lerinin kullan\u0131m ko\u015fullar\u0131, kota limitleri ve \u00fccretlendirme politikalar\u0131 zaman zaman de\u011fi\u015febilir, bu nedenle g\u00fcncel dok\u00fcmantasyonu d\u00fczenli olarak kontrol etmek \u00f6nemlidir. Kullan\u0131c\u0131 deneyimini en \u00fcst d\u00fczeye \u00e7\u0131karmak i\u00e7in g\u00f6rselle\u015ftirmeleri, hata y\u00f6netimini ve performans optimizasyonlar\u0131n\u0131 daima \u00f6n planda tutmal\u0131s\u0131n\u0131z. Android ekosisteminin sundu\u011fu esneklik ve Google Haritalar platformunun g\u00fcc\u00fcyle, kullan\u0131c\u0131lar\u0131n\u0131za etkileyici ve i\u015flevsel harita tabanl\u0131 deneyimler sunmaya haz\u0131rs\u0131n\u0131z.<\/body><\/p>\n","protected":false},"excerpt":{"rendered":"Android Google Haritalar’da \u0130ki Nokta Aras\u0131 Rota \u00c7izimi: Detayl\u0131 Teknik Rehber Android platformunda co\u011frafi konum tabanl\u0131 uygulamalar geli\u015ftirirken, kullan\u0131c\u0131lar\u0131n iki nokta aras\u0131nda bir rota \u00e7izebilmesi temel ve s\u0131k\u00e7a kar\u015f\u0131la\u015f\u0131lan bir gereksinimdir.","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"csco_page_header_type":"","csco_page_load_nextpost":"","csco_page_subscribe_form":"","csco_page_contact_form":"","footnotes":""},"categories":[1],"tags":[],"class_list":{"0":"post-41150","1":"post","2":"type-post","3":"status-publish","4":"format-standard","6":"category-genel","7":"cs-entry","8":"cs-video-wrap"},"yoast_head":"\nPolyline<\/code> nesnesi olarak haritaya ekleyece\u011fiz.<\/p>\nAPI Key<\/code>) alman\u0131z ve bunu uygulaman\u0131z\u0131n AndroidManifest.xml<\/code> dosyas\u0131na eklemeniz gerekmektedir.<\/p>\nGerekli \u0130zinler ve Ba\u011f\u0131ml\u0131l\u0131klar<\/h3>\n
android.permission.INTERNET<\/code> izni gereklidir.
\n* Konum \u0130zinleri<\/strong>: Kullan\u0131c\u0131n\u0131n mevcut konumunu haritada g\u00f6stermek isterseniz, android.permission.ACCESS_FINE_LOCATION<\/code> ve\/veya android.permission.ACCESS_COARSE_LOCATION<\/code> izinlerini talep etmeniz gerekir. Android 6.0 (API 23) ve \u00fczeri s\u00fcr\u00fcmlerde bu izinlerin \u00e7al\u0131\u015fma zaman\u0131nda (runtime<\/code>) kullan\u0131c\u0131dan talep edilmesi gerekti\u011fini unutmay\u0131n.
\n* Google Play Services<\/strong>: Google Haritalar SDK’s\u0131, Google Play Services’a ba\u011f\u0131ml\u0131d\u0131r. build.gradle<\/code> dosyan\u0131za a\u015fa\u011f\u0131daki ba\u011f\u0131ml\u0131l\u0131\u011f\u0131 eklemeniz gerekir:<\/p>\nimplementation 'com.google.android.gms:play-services-maps:18.x.x'<\/code><\/pre>\nimplementation 'com.google.maps.android:android-maps-utils:2.x.x'<\/code><\/pre>\nHarita Nesnesini Uygulamaya Entegre Etme<\/h2>\n
SupportMapFragment<\/code> veya MapView<\/code>. Genellikle SupportMapFragment<\/code> tercih edilir \u00e7\u00fcnk\u00fc ya\u015fam d\u00f6ng\u00fcs\u00fc y\u00f6netimini otomatik olarak halleder.<\/p>\nSupportMapFragment<\/code> veya MapView<\/code> Kullan\u0131m\u0131<\/h3>\nSupportMapFragment<\/code><\/strong>: Bir Fragment<\/code> olarak haritay\u0131 uygulaman\u0131z\u0131n bir b\u00f6l\u00fcm\u00fcne kolayca yerle\u015ftirmenizi sa\u011flar. Aktivite ya\u015fam d\u00f6ng\u00fcs\u00fc olaylar\u0131n\u0131 otomatik olarak y\u00f6netir. XML layout dosyan\u0131zda a\u015fa\u011f\u0131daki gibi tan\u0131mlan\u0131r:<\/p>\ngetMapAsync()<\/code> metodunu \u00e7a\u011f\u0131rarak harita haz\u0131r oldu\u011funda bir geri \u00e7a\u011f\u0131r\u0131m (callback<\/code>) al\u0131rs\u0131n\u0131z.
\n* MapView<\/code><\/strong>: Bir View<\/code> olarak haritay\u0131 do\u011frudan bir layout’a yerle\u015ftirmenizi sa\u011flar. Ancak, MapView<\/code>‘in ya\u015fam d\u00f6ng\u00fcs\u00fc olaylar\u0131n\u0131 (onCreate<\/code>, onStart<\/code>, onResume<\/code>, onPause<\/code>, onStop<\/code>, onDestroy<\/code>, onSaveInstanceState<\/code>) manuel olarak y\u00f6netmeniz gerekir. Daha fazla kontrol gerektiren \u00f6zel durumlar i\u00e7in uygundur.<\/p>\nOnMapReadyCallback<\/code> aray\u00fcz\u00fc \u00fczerinden onMapReady(GoogleMap googleMap)<\/code> metodu \u00e7a\u011fr\u0131l\u0131r. Bu metot i\u00e7inde GoogleMap<\/code> nesnesine eri\u015febilir ve harita \u00fczerinde i\u015flemler yapmaya ba\u015flayabilirsiniz.<\/p>\nHarita Ayarlar\u0131 ve Temel \u0130\u015flemler<\/h3>\n
onMapReady<\/code> metodu i\u00e7inde GoogleMap<\/code> nesnesini ald\u0131ktan sonra, haritan\u0131n g\u00f6r\u00fcn\u00fcm\u00fcn\u00fc ve davran\u0131\u015f\u0131n\u0131 \u00f6zelle\u015ftirebilirsiniz:<\/p>\ngoogleMap.moveCamera()<\/code> veya googleMap.animateCamera()<\/code> metodlar\u0131yla haritan\u0131n g\u00f6r\u00fcn\u00fcm\u00fcn\u00fc belirli bir LatLng<\/code> noktas\u0131na veya LatLngBounds<\/code> alan\u0131na ta\u015f\u0131yabilirsiniz. CameraUpdateFactory<\/code> s\u0131n\u0131f\u0131, kamera g\u00fcncellemeleri olu\u015fturmak i\u00e7in yard\u0131mc\u0131 metodlar sunar.
\n* Marker Ekleme<\/strong>: Belirli konumlar\u0131 i\u015faretlemek i\u00e7in MarkerOptions<\/code> nesnesi kullanarak googleMap.addMarker()<\/code> metodunu \u00e7a\u011f\u0131rabilirsiniz. Marker’lar, rota ba\u015flang\u0131\u00e7 ve biti\u015f noktalar\u0131n\u0131 g\u00f6rselle\u015ftirmek i\u00e7in \u00f6nemlidir.
\n* UI Ayarlar\u0131<\/strong>: Yak\u0131nla\u015ft\u0131rma kontrolleri, konum butonu, harita t\u00fcr\u00fc (uydu, arazi vb.) gibi UI bile\u015fenlerini etkinle\u015ftirebilir veya devre d\u0131\u015f\u0131 b\u0131rakabilirsiniz.<\/p>\nRota \u00c7izimi \u0130\u00e7in Gerekli Veri Kaynaklar\u0131: Google Directions API<\/h2>\n
Google Directions API’ye Giri\u015f<\/h3>\n
API \u0130ste\u011fi Yap\u0131s\u0131<\/h3>\n
origin<\/code><\/strong>: Ba\u015flang\u0131\u00e7 noktas\u0131n\u0131n enlem ve boylam\u0131 (\u00f6rn: 40.712776,-74.005974<\/code>).
\n* destination<\/code><\/strong>: Biti\u015f noktas\u0131n\u0131n enlem ve boylam\u0131.
\n* mode<\/code><\/strong>: Ula\u015f\u0131m modu (\u00f6rn: driving<\/code>, walking<\/code>, bicycling<\/code>, transit<\/code>).
\n* key<\/code><\/strong>: API anahtar\u0131n\u0131z.
\n* waypoints<\/code> (Opsiyonel)<\/strong>: Ara noktalar. Birden fazla ara nokta virg\u00fclle ayr\u0131labilir. optimize:true<\/code> parametresi ile en uygun s\u0131ra bulunabilir.
\n* alternatives<\/code> (Opsiyonel)<\/strong>: true<\/code> olarak ayarland\u0131\u011f\u0131nda, API birden fazla alternatif rota d\u00f6nd\u00fcrebilir.<\/p>\n
\nhttps:\/\/maps.googleapis.com\/maps\/api\/directions\/json?origin=40.712776,-74.005974&destination=40.758000,-73.985500&mode=driving&key=YOUR_API_KEY<\/code><\/p>\nAPI Yan\u0131t\u0131n\u0131n Ayr\u0131\u015ft\u0131r\u0131lmas\u0131<\/h3>\n
routes<\/code><\/strong>: Bulunan rotalar\u0131 i\u00e7eren bir dizi. Genellikle en uygun rota ilk eleman olarak gelir.
\n* legs<\/code><\/strong>: Her rota, bir veya daha fazla “leg” (bacak) i\u00e7erir. Her leg, bir ba\u015flang\u0131\u00e7 ve biti\u015f noktas\u0131 aras\u0131ndaki bir b\u00f6l\u00fcm\u00fc temsil eder.
\n* steps<\/code><\/strong>: Her leg, yol tarifinin ayr\u0131nt\u0131l\u0131 ad\u0131mlar\u0131n\u0131 i\u00e7eren “step” (ad\u0131m) dizisini bar\u0131nd\u0131r\u0131r.
\n* polyline<\/code><\/strong>: En kritik bilgi budur. Her route<\/code> nesnesinin i\u00e7inde, rotan\u0131n t\u00fcm geometrisini s\u0131k\u0131\u015ft\u0131r\u0131lm\u0131\u015f bir dize olarak i\u00e7eren bir overview_polyline<\/code> nesnesi bulunur. Bu nesnenin points<\/code> alan\u0131, rotay\u0131 haritada \u00e7izmek i\u00e7in kullanaca\u011f\u0131m\u0131z kodlanm\u0131\u015f poliline dizesini i\u00e7erir.<\/p>\nLatLng<\/code> noktas\u0131d\u0131r. Bu dizeyi tekrar LatLng<\/code> nesnelerinin bir listesine d\u00f6n\u00fc\u015ft\u00fcrmek i\u00e7in PolyUtil.decode()<\/code> metodunu (Google Maps Utility Library’den) kullanmam\u0131z gerekecektir.<\/p>\nRota \u00c7iziminin Ad\u0131m Ad\u0131m Uygulanmas\u0131<\/h2>\n
Ad\u0131m 1: Kullan\u0131c\u0131dan Ba\u015flang\u0131\u00e7 ve Biti\u015f Noktalar\u0131n\u0131 Alma<\/h3>\n
\n* Haritada T\u0131klama<\/strong>: Kullan\u0131c\u0131n\u0131n haritada bir noktaya t\u0131klamas\u0131n\u0131 sa\u011flayarak GoogleMap.setOnMapClickListener()<\/code> ile LatLng<\/code> koordinatlar\u0131n\u0131 alabilirsiniz.
\n* Mevcut Konum<\/strong>: Kullan\u0131c\u0131n\u0131n mevcut konumunu ba\u015flang\u0131\u00e7 noktas\u0131 olarak ayarlayabilirsiniz. Bunun i\u00e7in FusedLocationProviderClient<\/code> gibi konum servislerini kullanman\u0131z gerekir.<\/p>\nLatLng<\/code> objelerine sahip oldu\u011fumuzu varsayarak ilerleyece\u011fiz.<\/p>\nAd\u0131m 2: Directions API \u0130ste\u011fi Olu\u015fturma<\/h3>\n
\n * HttpURLConnection<\/code>: Android’in yerle\u015fik HTTP istemcisi.
\n * OkHttp<\/code>: Modern ve verimli bir HTTP istemcisi.
\n * Retrofit<\/code>: REST API’leriyle \u00e7al\u0131\u015fmak i\u00e7in tip g\u00fcvenli bir HTTP istemcisi. \u00d6zellikle karma\u015f\u0131k API’ler i\u00e7in \u00f6nerilir.
\n* Arka Plan \u0130\u015flemleri<\/strong>:
\n * AsyncTask<\/code> (eski): Basit i\u015flemler i\u00e7in hala kullan\u0131labilir.
\n * Kotlin Coroutines<\/code>: Kotlin projeleri i\u00e7in modern ve \u00f6nerilen e\u015fzamans\u0131z programlama yakla\u015f\u0131m\u0131.
\n * RxJava<\/code>: G\u00fc\u00e7l\u00fc reaktif programlama k\u00fct\u00fcphanesi.<\/p>\n\/\/ \u00d6rnek bir URL olu\u015fturma\nString url = \"https:\/\/maps.googleapis.com\/maps\/api\/directions\/json?\" +\n \"origin=\" + startLatLng.latitude + \",\" + startLatLng.longitude +\n \"&destination=\" + endLatLng.latitude + \",\" + endLatLng.longitude +\n \"&mode=driving\" +\n \"&key=YOUR_API_KEY\";\n\n\/\/ Bu URL'ye arka planda bir HTTP iste\u011fi g\u00f6nderin ve JSON yan\u0131t\u0131n\u0131 al\u0131n.\n\/\/ Yan\u0131t\u0131 bir String olarak d\u00f6nd\u00fcr\u00fcn.<\/code><\/pre>\nAd\u0131m 3: API Yan\u0131t\u0131n\u0131 \u0130\u015fleme ve Poliline Verisini \u00c7\u0131karma<\/h3>\n
JSONObject<\/code> ve JSONArray<\/code> s\u0131n\u0131flar\u0131n\u0131 kullanabilir veya Gson<\/code> gibi k\u00fct\u00fcphanelerden faydalanabilirsiniz.<\/p>\nJSONObject<\/code>‘e d\u00f6n\u00fc\u015ft\u00fcr\u00fcn.
\n2. \"routes\"<\/code> dizisini al\u0131n.
\n3. Genellikle ilk rotay\u0131 (en uygun olan\u0131) se\u00e7in.
\n4. Bu rotan\u0131n i\u00e7indeki \"overview_polyline\"<\/code> nesnesini ve onun \"points\"<\/code> alan\u0131n\u0131 al\u0131n. Bu alan, kodlanm\u0131\u015f poliline dizesidir.
\n5. Bu dizeyi PolyUtil.decode(encodedPolylineString)<\/code> metodu ile LatLng<\/code> nesnelerinin bir listesine d\u00f6n\u00fc\u015ft\u00fcr\u00fcn. Bu metod, Google Maps Utility Library’den gelir.<\/p>\n\/\/ \u00d6rnek JSON ayr\u0131\u015ft\u0131rma mant\u0131\u011f\u0131\nJSONObject jsonResponse = new JSONObject(jsonString);\nJSONArray routes = jsonResponse.getJSONArray(\"routes\");\nif (routes.length() > 0) {\n JSONObject route = routes.getJSONObject(0);\n JSONObject overviewPolyline = route.getJSONObject(\"overview_polyline\");\n String encodedPolyline = overviewPolyline.getString(\"points\");\n\n \/\/ Poliline dizesini LatLng listesine d\u00f6n\u00fc\u015ft\u00fcr\n ListAd\u0131m 4: Haritaya Poliline \u00c7izme<\/h3>\n
LatLng<\/code> listesini ald\u0131ktan sonra, bu listeyi kullanarak haritada bir poliline \u00e7izebilirsiniz.<\/p>\nPolylineOptions<\/code> nesnesi olu\u015fturun.
\n2. add()<\/code> metodunu kullanarak decodedPath<\/code> listesindeki t\u00fcm LatLng<\/code> noktalar\u0131n\u0131 ekleyin.
\n3. Polilinenin rengini (color<\/code>), geni\u015fli\u011fini (width<\/code>), \u015feffafl\u0131\u011f\u0131n\u0131 (alpha<\/code>), ba\u015flang\u0131\u00e7 ve biti\u015f kapaklar\u0131n\u0131 (startCap<\/code>, endCap<\/code>) ve birle\u015fim stilini (jointType<\/code>) ayarlayabilirsiniz.
\n4. googleMap.addPolyline(polylineOptions)<\/code> metodunu \u00e7a\u011f\u0131rarak polilineyi haritaya ekleyin.<\/p>\nPolylineOptions polylineOptions = new PolylineOptions()\n .addAll(decodedPath)\n .width(10) \/\/ Piksel cinsinden geni\u015flik\n .color(Color.BLUE) \/\/ Rota rengi\n .geodesic(true); \/\/ Ger\u00e7ek d\u00fcnya e\u011frili\u011fini hesaba katma\n\ngoogleMap.addPolyline(polylineOptions);<\/code><\/pre>\nAd\u0131m 5: Ba\u015flang\u0131\u00e7 ve Biti\u015f Noktalar\u0131na Marker Ekleme<\/h3>\n
MarkerOptions<\/code> nesnesi olu\u015fturun, konumunu (position<\/code>), ba\u015fl\u0131\u011f\u0131n\u0131 (title<\/code>) ve ikonunu (icon<\/code>) ayarlay\u0131n.
\n2. Biti\u015f noktas\u0131 i\u00e7in de benzer bir MarkerOptions<\/code> nesnesi olu\u015fturun.
\n3. googleMap.addMarker()<\/code> metodunu \u00e7a\u011f\u0131rarak her iki marker’\u0131 da haritaya ekleyin.<\/p>\ngoogleMap.addMarker(new MarkerOptions()\n .position(startLatLng)\n .title(\"Ba\u015flang\u0131\u00e7 Noktas\u0131\")\n .icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_GREEN)));\n\ngoogleMap.addMarker(new MarkerOptions()\n .position(endLatLng)\n .title(\"Biti\u015f Noktas\u0131\")\n .icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_RED)));<\/code><\/pre>\nAd\u0131m 6: Harita Kameras\u0131n\u0131 Rotaya Odaklama<\/h3>\n
LatLngBounds.Builder<\/code> nesnesi olu\u015fturun.
\n2. include()<\/code> metodunu kullanarak ba\u015flang\u0131\u00e7 ve biti\u015f noktalar\u0131n\u0131n LatLng<\/code>‘lerini (veya rotadaki t\u00fcm noktalar\u0131) bu s\u0131n\u0131rlara dahil edin.
\n3. build()<\/code> metodunu \u00e7a\u011f\u0131rarak LatLngBounds<\/code> nesnesini olu\u015fturun.
\n4. CameraUpdateFactory.newLatLngBounds(bounds, padding)<\/code> metodunu kullanarak bir CameraUpdate<\/code> olu\u015fturun. padding<\/code> parametresi, rotan\u0131n haritan\u0131n kenarlar\u0131na \u00e7ok yak\u0131n olmamas\u0131n\u0131 sa\u011flar.
\n5. googleMap.animateCamera(cameraUpdate)<\/code> metodunu \u00e7a\u011f\u0131rarak kameray\u0131 rotaya odaklay\u0131n.<\/p>\nLatLngBounds.Builder builder = new LatLngBounds.Builder();\nbuilder.include(startLatLng);\nbuilder.include(endLatLng);\n\/\/ \u0130ste\u011fe ba\u011fl\u0131 olarak, decodedPath'deki t\u00fcm noktalar\u0131 da dahil edebilirsiniz:\n\/\/ for (LatLng point : decodedPath) {\n\/\/ builder.include(point);\n\/\/ }\nLatLngBounds bounds = builder.build();\n\nint padding = 100; \/\/ Kenarlardan 100 piksel bo\u015fluk\nCameraUpdate cu = CameraUpdateFactory.newLatLngBounds(bounds, padding);\ngoogleMap.animateCamera(cu);<\/code><\/pre>\nGeli\u015fmi\u015f \u00d6zellikler ve Optimizasyonlar<\/h2>\n
Birden Fazla Rota ve Alternatifler<\/h3>\n
alternatives=true<\/code> parametresini eklerseniz, API birden fazla olas\u0131 rota d\u00f6nd\u00fcrebilir. Bu durumda, JSON yan\u0131t\u0131ndaki routes<\/code> dizisi birden fazla eleman i\u00e7erecektir. Her bir rotay\u0131 ayr\u0131 ayr\u0131 ayr\u0131\u015ft\u0131r\u0131p haritada farkl\u0131 renklerde veya stillerde poliline’lar olarak \u00e7izebilir ve kullan\u0131c\u0131ya se\u00e7im yapma imkan\u0131 sunabilirsiniz.<\/p>\nAra Noktalar (Waypoints) Kullan\u0131m\u0131<\/h3>\n
waypoints<\/code> parametresi ile Directions API’ye ara noktalar ekleyebilirsiniz. Bu ara noktalar virg\u00fclle ayr\u0131lm\u0131\u015f LatLng<\/code> koordinatlar\u0131 veya adresler olabilir. Ayr\u0131ca, waypoints=optimize:true|...<\/code> parametresini kullanarak API’nin ara noktalar aras\u0131ndaki en optimize edilmi\u015f s\u0131ray\u0131 bulmas\u0131n\u0131 sa\u011flayabilirsiniz.<\/p>\nRota Modlar\u0131 (Driving, Walking, Bicycling, Transit)<\/h3>\n
mode<\/code> parametresini de\u011fi\u015ftirerek farkl\u0131 ula\u015f\u0131m t\u00fcrleri i\u00e7in rota alabilirsiniz:<\/p>\ndriving<\/code> (varsay\u0131lan): Araba ile s\u00fcr\u00fc\u015f.
\n* walking<\/code>: Y\u00fcr\u00fcme.
\n* bicycling<\/code>: Bisiklet.
\n* transit<\/code>: Toplu ta\u015f\u0131ma (genellikle departure_time<\/code> veya arrival_time<\/code> gibi ek parametreler gerektirir).<\/p>\nHata Y\u00f6netimi ve Kullan\u0131c\u0131 Geri Bildirimi<\/h3>\n
\n* API Yan\u0131t Hatalar\u0131<\/strong>: Directions API, status<\/code> alan\u0131nda ZERO_RESULTS<\/code>, NOT_FOUND<\/code>, OVER_QUERY_LIMIT<\/code> gibi durum kodlar\u0131 d\u00f6nd\u00fcrebilir. Bu durumlar\u0131 kontrol edin ve kullan\u0131c\u0131ya uygun mesajlar g\u00f6sterin (\u00f6rn: “Bu iki nokta aras\u0131nda rota bulunamad\u0131”, “API kota a\u015f\u0131ld\u0131”).
\n* Konum Hatalar\u0131<\/strong>: Kullan\u0131c\u0131n\u0131n girdi\u011fi konumlar ge\u00e7ersiz olabilir.
\n* Kullan\u0131c\u0131 Aray\u00fcz\u00fc<\/strong>: Hata mesajlar\u0131n\u0131 Toast<\/code>, Snackbar<\/code> veya AlertDialog<\/code> ile g\u00f6sterin. Y\u00fckleme g\u00f6stergeleri (ProgressBar<\/code>) kullanarak API iste\u011fi s\u0131ras\u0131nda kullan\u0131c\u0131ya geri bildirim sa\u011flay\u0131n.<\/p>\nPerformans Optimizasyonu<\/h3>\n
AsyncTask<\/code>, Coroutines<\/code> veya RxJava<\/code> gibi yap\u0131lar kullan\u0131n.
\n* Gereksiz Yeniden \u00c7izimleri \u00d6nleme<\/strong>: E\u011fer rota verisi de\u011fi\u015fmediyse, haritay\u0131 tekrar tekrar \u00e7izmekten ka\u00e7\u0131n\u0131n.
\n* Nesne Havuzlama<\/strong>: \u00c7ok say\u0131da marker veya poliline ekleyip \u00e7\u0131kar\u0131yorsan\u0131z, nesne havuzlama tekniklerini d\u00fc\u015f\u00fcnebilirsiniz.
\n* Bellek Kullan\u0131m\u0131<\/strong>: \u00d6zellikle uzun rotalar ve \u00e7ok say\u0131da nokta i\u00e7in LatLng<\/code> listelerinin bellek kullan\u0131m\u0131n\u0131 g\u00f6z \u00f6n\u00fcnde bulundurun.<\/p>\nGoogle Maps Utility Library Kullan\u0131m\u0131<\/h3>\n
PolyUtil.decode()<\/code> metodunun yan\u0131 s\u0131ra, Google Maps Utility Library ba\u015fka kullan\u0131\u015fl\u0131 ara\u00e7lar da sunar:<\/p>\nSphericalUtil<\/code><\/strong>: \u0130ki LatLng<\/code> noktas\u0131 aras\u0131ndaki mesafeyi, alan\u0131 veya bearing’i hesaplamak gibi co\u011frafi hesaplamalar i\u00e7in.
\n* MarkerManager<\/code> ve ClusterManager<\/code><\/strong>: \u00c7ok say\u0131da marker’\u0131 verimli bir \u015fekilde y\u00f6netmek ve yak\u0131n marker’lar\u0131 k\u00fcmelemek i\u00e7in.<\/p>\nS\u0131k\u00e7a Kar\u015f\u0131la\u015f\u0131lan Sorunlar ve \u00c7\u00f6z\u00fcmleri<\/h2>\n
API_KEY_INVALID<\/code>, API_KEY_NOT_AUTHORIZED<\/code>)<\/strong>:
\n * API anahtar\u0131n\u0131z\u0131n do\u011fru oldu\u011fundan ve AndroidManifest.xml<\/code> dosyan\u0131zda do\u011fru yere (
\n * Google Cloud Console’da Haritalar SDK’s\u0131 ve Directions API’nin etkinle\u015ftirildi\u011fini kontrol edin.
\n * API anahtar\u0131n\u0131za uygulaman\u0131z\u0131n paket ad\u0131n\u0131 ve SHA-1 parmak izini ekleyerek k\u0131s\u0131tlamalar\u0131 do\u011fru yap\u0131land\u0131rd\u0131\u011f\u0131n\u0131zdan emin olun.
\n* Directions API Kota A\u015f\u0131mlar\u0131 (OVER_QUERY_LIMIT<\/code>)<\/strong>:
\n * Belirli bir zaman diliminde \u00e7ok fazla istek g\u00f6nderiyorsunuz demektir. API kullan\u0131m\u0131n\u0131z\u0131 optimize edin veya Google Cloud Console’dan kota art\u0131r\u0131m\u0131 talep edin (\u00fccretli olabilir).
\n * Gereksiz isteklerden ka\u00e7\u0131nmak i\u00e7in rota verilerini \u00f6nbelle\u011fe almay\u0131 d\u00fc\u015f\u00fcnebilirsiniz.
\n* SecurityException<\/code> (\u0130zin Eksikli\u011fi)<\/strong>:
\n * AndroidManifest.xml<\/code> dosyan\u0131zda gerekli INTERNET<\/code> ve ACCESS_FINE_LOCATION<\/code> gibi izinlerin tan\u0131mland\u0131\u011f\u0131ndan emin olun.
\n * Android 6.0 ve \u00fczeri i\u00e7in \u00e7al\u0131\u015fma zaman\u0131 izinlerini do\u011fru bir \u015fekilde talep etti\u011finizden emin olun.
\n* Haritan\u0131n Y\u00fcklenmemesi (Gri Ekran)<\/strong>:
\n * API anahtar\u0131n\u0131z\u0131n do\u011fru oldu\u011fundan ve k\u0131s\u0131tlamalar\u0131n do\u011fru yap\u0131land\u0131r\u0131ld\u0131\u011f\u0131ndan emin olun.
\n * Cihazda Google Play Services’\u0131n g\u00fcncel ve etkin oldu\u011fundan emin olun.
\n * A\u011f ba\u011flant\u0131s\u0131n\u0131 kontrol edin.
\n* JSON Ayr\u0131\u015ft\u0131rma Hatalar\u0131<\/strong>:
\n * API yan\u0131t\u0131n\u0131n format\u0131n\u0131 dikkatlice inceleyin. Bazen API yan\u0131t\u0131 beklenenden farkl\u0131 bir yap\u0131ya sahip olabilir (\u00f6rn: ZERO_RESULTS<\/code> durumunda routes<\/code> dizisi bo\u015f olabilir).
\n * try-catch<\/code> bloklar\u0131 kullanarak JSON ayr\u0131\u015ft\u0131rma hatalar\u0131n\u0131 yakalay\u0131n.<\/p>\nSonu\u00e7<\/h2>\n