MAKALAH
Diajukan sebagai Salah Satu Syarat
untuk Memperoleh Nilai Plagirism Checker sebagai syarat kelulusan Pelatihan ICT
2018
Oleh
ALWAN YASSIN
1167050023
BANDUNG
2018 M/1439 H
DAFTAR ISI
KATA PENGANTAR
Puji syukur kehadirat Allah Subhanahu Wata’ala atas limpahan
nikmatnya sehingga makalah ini dapat diselesaikan dengan baik.
Tidak lupa penulis ucapkan terima kasih kepada berbagai pihak
baik yang telah membantu secara langsung atau tidak langsung dalam proses
penyusunan makalah ini.
Makalah ini membahas tentang cara penggunaan Google Maps API
yang berfokus pada bagian webservicenya dan untuk digunakan pada seluruh
platform yang mendukung JSON. Dimulai dari pengenalan Google Maps API itu
sendiri sampai contoh source code penggunaannya.
Akhirnya penulis menyadari bahwa dalam penyusunan makalah ini
tak lepas dari kekurangan disana sini, oleh karenanya penulis memohon kritik
saran dan masukan demi perbaikan untuk kedepannya.
BAB I
PENDAHULUAN
1.1 Latar Belakang
Perkembangan teknologi pada saat ini
sangatlah pesat. Bisa kita lihat dari banyaknya inovasi baru yang bermunculan
dan berujung menghasilkan produk yang membuat kehidupan kita semakin mudah
berkat teknologi itu sendiri. Salah satu teknologi yang sering dimanfaatkan
dalam produk inovasi terkini seperti GO-JEK, GRAB, Uber dan lain-lain adalah
Google Maps.
Google Maps sendiri merupakan
teknologi berbentuk aplikasi yang dibuat oleh Google untuk memudahkan
penggunanya dalam mencari informasi melalui peta virtual yang fungsinya
bermacam-macam seperti untuk membantu pembuatan sistem informasi geografis
dimana dalam hal ini Google Maps berperan sebagai penyedia lokasi yang akan
dianalisa objek dan fenomenanya[3].
Untuk dapat mengakses fungsi-fungsi
yang terdapat pada Google Maps, pengembang aplikasi dapat menggunakan Application Programming Interface(API)
yang telah disediakan oleh Google sendiri.
Karena dokumentasi API yang disediakan oleh Google saat ini
hanya tersedia dalam bahasa Inggris saja, penulis berinisiatif untuk membahas
dokumentasi API tersebut dalam bahasa
Indonesia untuk mempermudah orang yang belum mengerti bahasa Inggris dalam memahami
maksud dari konten dokumentasi tersebut.
1.2 Rumusan
Masalah
1.
Apa
saja yang termasuk Google Maps Webservice API?
2.
Bagaimana
cara penggunaan Google Maps Webservice API?
1.3 Tujuan
1.
Pembaca
dapat mengetahui apa saja yang termasuk Google Maps Webservice API
2.
Pembaca
dapat mengetahui cara penggunaan Google Maps Webservice API
BAB II
PEMBAHASAN
2.1 Webservice
pada Google Maps API
Pada halaman dokumentasi Google Maps, terdapat
beberapa jenis API yang tersedia, diantaranya adalah API bagian Webservice.
Berikut adalah macam-macam API Webservice yang ada pada Google Maps:
Directions API
API ini adalah sebuah layanan yang mengkalkulasi arah
antara satu lokasi ke lokasi lainnya. Dengan menggunakan API ini kita bisa
melakukan hal sebagai berikut:
·
Mencari
arah ke suatu tempat untuk beberapa jenis transportasi termasuk transit,
kendaraan pribadi(mobil atau motor), berjalan kaki ataupun bersepeda.
·
Mendapatkan
beberapa arah ke suatu tempat menggunakan serangkaian titik jalan
·
Menentukan
tempat asal, tempat tujuan, dan titik jalan sebagai text strings, atau sebagai
koordinat garis lintang dan bujur, ataupun ID tempat.
Distance Matrix API
API ini adalah sebuah layanan yang menyediakan jarak
dan waktu tempuh untuk sebuah matriks dari tempat asal dan tempat tujuan
berdasarkan rute rekomendasi diantara titik awal dan titik akhir.
Elevation API
API ini menyediakan data ketinggian untuk semua lokasi
daratan yang ada di bumi termasuk kedalaman lokasi pada dasar laut.
Geocoding API
API ini adalah sebuah layanan yang menyediakan geocoding(konversi
nama tempat menjadi koordinat garis lintang dan garis bujur) dan reverse
geocoding atau kebalikan dari geocoding itu sendiri. Geocoding memiliki
pengertian yaitu sebuah praktik menetapkan pengenal geografis ke database
sebuah sistem komputer[2].
Geolocation API
API ini mengembalikan nilai berupa lokasi dan radius
akurasi berdasarkan informasi tentang cell towers dan node WiFi yang klien
mobile dapat mendeteksinya. Geolocation sendiri yaitu suatu teknik untuk
melacak lokasi menggunakan data koordinat garis lintang dan garis bujur yang
dimiliki oleh perangkat smartphone maupun computer[1].
Places API
API ini adalah sebuah layanan yang mengembalikan nilai
berupa informasi tentang banyak tempat. Informasi tempat yang dimaksud dapat
berupa list tempat dari hasil pencarian user, detil tempat secara spesifik, dan
foto dari tempat.
Roads API
API ini mengidentifikasi jalan-jalan yang dilalui
kendaraan dan memberikan metadata tambahan tentang jalan-jalan tersebut,
seperti batas kecepatan.
Time Zone API
API ini menyediakan data waktu offset untuk lokasi di
permukaan bumi. Request untuk API ini berupa informasi lokasi dan waktu.
Sedangkan hasil yang dikembalikan oleh API ini adalah informasi daylight
savings time offset, raw offset, timezoneID, dan timezoneName.
2.2 Cara
Penggunaan Webservice API Google Maps
Penggunaan Webservice API Google Maps sebenarnya sama
seperti menggunakan API pada umumnya yaitu kita harus mengetahui bagaimana url
API nya, bentuk parameter request dan parameter dari hasil request tadi.
Berikut adalah penggunaan Webservice API Google Maps:
Directions
API
Cara
Request ke API
|
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
|
URL:
Keterangan URL:
·
outputFormat diisi
dengan json atau xml. Tergantung anda
·
parameters diisi
dengan yang ada pada table parameter directions API dibawah ini.
·
Untuk penulisan
parameter lebih dari satu, gunakan tanda “&”.
Misal
“origin=Bandung&destination=Jakarta”
Table
1 – Parameter untuk Directions API
|
Parameter
|
Isi
|
|
origin
|
Untuk
diisi dengan tempat asal
|
|
destination
|
Untuk
diisi dengan tempat tujuan
|
|
key
|
Untuk
diisi dengan key API yang anda miliki
|
|
mode
|
Untuk
diisi dengan mode transportasi yang digunakan
|
|
waypoints
|
Untuk
diisi dengan array dari beberapa titik jalan
|
|
alternatives
|
Untuk
diisi dengan true atau false.
|
|
avoid
|
Untuk
diisi dengan sesuatu yang harus dihindari. Misal jalan tol, jalan raya, kapal
feri dll
|
|
language
|
Untuk
diisi dengan bahasa yang ingin dipakai untuk hasil API.
|
|
units
|
Untuk
diisi dengan metric atau imperial. Jika metric maka menjadi kilometer dan
meter. Jika imperial maka menjadi mil dan kaki
|
|
region
|
Untuk
diisi dengan penetuan regional
|
|
arrival_time
|
Untuk
diisi dengan waktu kedatangan
|
|
departure_time
|
Untuk
diisi dengan waktu keberangkatan
|
|
traffic_model
|
Untuk
diisi dengan best_guess, pessimistic atau optimistic
|
|
transit_mode
|
Untuk
diisi dengan bus, subway, train, tram, atau rail
|
|
transit_routing_preference
|
Untuk
diisi dengan less_walking atau fewer_transfers
|
|
https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=123456
|
Contoh Request:
Distance
Matrix API
Cara
Request ke API
|
https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
|
URL:
Keterangan URL:
·
outputFormat diisi
dengan json atau xml. Tergantung anda
·
parameters diisi
dengan yang ada pada table parameter distance matrix API dibawah ini.
·
Untuk penulisan
parameter lebih dari satu, gunakan tanda “&”.
Misal
“origin=Bandung&destination=Jakarta”
Table
2 – Parameter untuk Distance Matrix API
|
Parameter
|
Isi
|
|
origin
|
Untuk
diisi dengan tempat asal
|
|
destination
|
Untuk
diisi dengan tempat tujuan
|
|
key
|
Untuk
diisi dengan key API yang anda miliki
|
|
mode
|
Untuk
diisi dengan mode transportasi yang digunakan
|
|
waypoints
|
Untuk
diisi dengan array dari beberapa titik jalan
|
|
alternatives
|
Untuk
diisi dengan true atau false.
|
|
avoid
|
Untuk
diisi dengan sesuatu yang harus dihindari. Misal jalan tol, jalan raya, kapal
feri dll
|
|
language
|
Untuk
diisi dengan bahasa yang ingin dipakai untuk hasil API.
|
|
units
|
Untuk
diisi dengan metric atau imperial. Jika metric maka menjadi kilometer dan
meter. Jika imperial maka menjadi mil dan kaki
|
|
region
|
Untuk
diisi dengan penetuan regional
|
|
arrival_time
|
Untuk
diisi dengan waktu kedatangan
|
|
departure_time
|
Untuk
diisi dengan waktu keberangkatan
|
|
traffic_model
|
Untuk
diisi dengan best_guess, pessimistic atau optimistic
|
|
transit_mode
|
Untuk
diisi dengan bus, subway, train, tram, atau rail
|
|
transit_routing_preference
|
Untuk
diisi dengan less_walking atau fewer_transfers
|
|
https://maps.googleapis.com/maps/api/distancematrix/json?origins=Vancouver+BC|Seattle&destinations=San+Francisco|Victoria+BC&mode=bicycling&language=fr-FR&key=YOUR_API_KEY
|
Contoh Request:
Elevation
API
Cara
Request ke API
|
https://maps.googleapis.com/maps/api/elevation/outputFormat?parameters
|
URL:
Keterangan URL:
·
outputFormat diisi
dengan json atau xml. Tergantung anda
·
parameters diisi
dengan yang ada pada table parameter elevation API dibawah ini.
·
Untuk penulisan
parameter lebih dari satu, gunakan tanda “&”.
Misal
“origin=Bandung&destination=Jakarta”
Table
3 – Parameter untuk Elevation API
|
Parameter
|
Isi
|
|
locations
|
Untuk
diisi dengan lokasi yang ingin dilihat ketinggiannya
|
|
path
|
Untuk
diisi dengan jalan yang ingin dilihat ketinggiannya
|
|
samples
|
-
|
|
key
|
Untuk
diisi dengan key API yang anda miliki
|
|
https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536,-104.9847034|36.455556,-116.866667&key=YOUR_API_KEY
|
Contoh Request:
Geocoding
API
Cara
Request ke API
|
https://maps.googleapis.com/maps/api/geocode/outputFormat?parameters
|
URL:
Keterangan URL:
·
outputFormat diisi
dengan json atau xml. Tergantung anda
·
parameters diisi
dengan yang ada pada table parameter Geocoding API dibawah ini.
·
Untuk penulisan
parameter lebih dari satu, gunakan tanda “&”.
Misal
“origin=Bandung&destination=Jakarta”
Table
4 – Parameter untuk Geocoding API
|
Parameter
|
Isi
|
|
address
|
Untuk
diisi dengan alamat jalan yang ingin kita geocode
|
|
components
|
Untuk
diisi dengan jalan yang ingin dilihat ketinggiannya
|
|
key
|
Untuk
diisi dengan key API yang anda miliki
|
|
bounds
|
-
|
|
language
|
Untuk
diisi dengan bahasa yang ingin dipakai untuk hasil API.
|
|
region
|
Untuk
diisi dengan penetuan regional
|
|
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
|
Contoh Request:
Geolocation
API
Cara
Request ke API
|
https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY
|
URL:
Keterangan URL:
·
Khusus untuk
Geolocation API, request dilakukan dengan method POST
·
Request berupa
JSON. Untuk melihat format JSON untuk requestnya bisa dilihat dibawah ini.
|
{
"homeMobileCountryCode":
310,
"homeMobileNetworkCode": 410,
"radioType": "gsm",
"carrier": "Vodafone",
"considerIp": "true",
"cellTowers": [
"cellId": 42,
"locationAreaCode": 415,
"mobileCountryCode": 310,
"mobileNetworkCode": 410,
"age": 0,
"signalStrength": -60,
"timingAdvance": 15
],
"wifiAccessPoints": [
"macAddress": "00:25:9c:cf:1c:ac",
"signalStrength": -43,
"age": 0,
"channel": 11,
"signalToNoiseRatio": 0 ]
}
|
Contoh Request:
Time Zone API
Cara
Request ke API
|
https://maps.googleapis.com/maps/api/timezone/outputFormat?parameters
|
URL:
Keterangan URL:
·
outputFormat diisi
dengan json atau xml. Tergantung anda
·
parameters diisi
dengan yang ada pada table parameter Time Zone API dibawah ini.
·
Untuk penulisan
parameter lebih dari satu, gunakan tanda “&”.
Misal
“origin=Bandung&destination=Jakarta”
Table
5 – Parameter untuk Time Zone API
|
Parameter
|
Isi
|
|
location
|
Untuk
diisi dengan lokasi yang kita ingin ketahui time zonenya
|
|
timestamp
|
Untuk
diisi dengan waktu setempat
|
|
key
|
Untuk
diisi dengan key API yang anda miliki
|
|
language
|
Untuk
diisi dengan bahasa yang ingin dipakai untuk hasil API.
|
|
https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510×tamp=1331161200&key=YOUR_API_KEY
|
Contoh Request:
BAB III
PENUTUP
3.1 Kesimpulan
Google Maps Webservice API memiliki beberapa bagian
yaitu Directions, Distance Matrix, Elevation, Geocoding, Geolocation, Places,
Roads, dan Time Zone. Masing-masing memiliki fungsi tersendiri.
Cara menggunakan Google Maps Webservice API sama
dengan penggunaan API pada umumnya. Pertama kita harus mengetahui URL dari API
yang ingin kita gunakan, kedua kita harus mengetahui parameter yang dibutuhkan
oleh setiap API, dan terakhir yaitu kita harus memiliki key API untuk dapat
melakukan request terhadap API itu sendiri yang bisa kita dapatkan langsung
dari web console developer Google.
DAFTAR PUSTAKA
|
[1]
|
K. F. King,
"Geolocation and Federalism on the Internet: Cutting Internet
Gambling's Gordian Knot.Geolocation," United States Court of
Appeals for the Fourth Circuit, 2009.
|
|
[2]
|
R. Gerard, P. A.
Marc, G. Josephine and etc, "Geocoding in cancer research: a
review," American Journal of Preventive Medicine, pp. 16-24,
2006.
|
|
[3]
|
M. Purvis and dkk,
Beginning Google Maps Application with PHP and Ajax, United States: Apress,
2006.
|
|
[4]
|
Google,
"Google Maps Platform | Google Developer," Google, 2018.
[Online]. Available: https://developers.google.com/maps/documentation/.
[Accessed 12 November 2018].
|
|
|
|
