Giter VIP home page Giter VIP logo

laravel-api-samarinda's Introduction

Laravel Samarinda API (Application Programming Inteface)

Total Downloads Build Status Latest Stable Version Latest Unstable Version License

Package Laravel untuk memudahkan developer lokal khususnya para programmer di Samarinda dalam pemanfaatan API yang disediakan oleh Pemerintah Kota Samarinda.

Tentang

Untuk menjawab seluruh kebutuhan para developer lokal akan data, Pemerintah Kota Samarinda membuat sebuah Package Laravel untuk memudahkan developer lokal khususnya para programmer di Samarinda dalam pemanfaatan API yang disediakan oleh Pemerintah Kota Samarinda.

Requirements

Instalasi

Laravel 5.5 Ke Atas
  1. Jalankan perintah berikut melalui terminal (Linux & Mac) atau Command Prompt (Windows):
    composer require novay/laravel-api-samarinda
  • Package ini menggunakan fitur auto discovery.
Laravel 5.4 Ke Bawah (Optional untuk Laravel 5.5)
  1. Tambahkan baris berikut pada file config/app.php pada masing-masing lokasi providers dan aliases:
'providers' => [
    Novay\ApiSamarinda\ApiSamarindaServiceProvider::class, 
];

'aliases' => [
    'ApiSamarinda' => Novay\ApiSamarinda\Facade::class, 
];
Konfigurasi
  1. Jalankan perintah berikut:
php artisan vendor:publish --provider="Novay\ApiSamarinda\ApiSamarindaServiceProvider"
  1. Tambahkan beberapa settingan berikut kedalam file .env Anda:
# Samarinda API Settings, SMR_TOKEN are required.
SMR_API='http://api.samarindakota.go.id/api'
SMR_API_VERSION='v1'
SMR_TOKEN='API_KEY_ANDA'
  1. Buat akun dan dapatkan TOKEN Anda di http://api.samarindakota.go.id.

Panduan Penggunaan

Sementara to the point begini dulu ya.

# DEVELOPER RESMI

// Untuk menampilkan seluruh data penduduk di Kota Samarinda. Note: 15 Penduduk per Page
return ApiSamarinda::penduduk();
// Untuk menampilkan data Penduduk berdasarkan NIK (Khusus KTP Samarinda)
return ApiSamarinda::pendudukByNik(6403050611910002);


# DEVELOPER BIASA

// Untuk melakukan pemanggilan menggunakan URL lengkap
return ApiSamarinda::url('GET', 'http://api.samarindakota.go.id/api/v1/sekolah?with=both&jenjang=smk', true);

// Menampilkan seluruh data provinsi di Indonesia
return ApiSamarinda::provinsi();
// Menampilkan data provinsi per paginasi (Tentukan sendiri berapa yang mau ditampilkan per Halaman)
return ApiSamarinda::provinsi(15);
// Menampilkan data provinsi berdasarkan ID (List ID Provinsi segera dibuatkan halaman khusus)
return ApiSamarinda::provinsiById($id_provinsi);
// Melakukan pencarian provinsi berdasarkan kata kunci, dalam hal ini adalah "nama"
return ApiSamarinda::provinsiByNama('kalimantan timur');

// Penjelasan sama dengan provinsi
return ApiSamarinda::kota();
return ApiSamarinda::kota(15);
return ApiSamarinda::kotaById(1103);
return ApiSamarinda::kotaByNama('samarinda');
// Menampilkan seluruh Kota yang ada di Provinsi sesuai dengan ID Provinsi yang ditentukan
return ApiSamarinda::kotaByIdProvinsi(64);

// Penjelasan sama dengan Provinsi dan Kota
return ApiSamarinda::kecamatan();
return ApiSamarinda::kecamatan(15);
return ApiSamarinda::kecamatanById(1101030);
return ApiSamarinda::kecamatanByNama('redeb');
return ApiSamarinda::kecamatanByIdKota(6472);

// Penjelasan sama dengan Provinsi, Kota dan Kecamatan
return ApiSamarinda::kelurahan();
return ApiSamarinda::kelurahan(15);
return ApiSamarinda::kelurahanById(1101010007);
return ApiSamarinda::kelurahanByNama('redeb');
return ApiSamarinda::kelurahanByIdKecamatan(6405060);

// Menampilkan seluruh data sekolah yang ada di Kota Samarinda (Data diambil langsung dari Dapodik)
return ApiSamarinda::sekolah();

// Berhubung nama kecamatan dan kelurahan ditampilkan dalam bentuk Kode, 
// gunakan parameter berikut untuk menampilkan kecamatan dan kelurahan dalam bentuk nama.
// 1. 'kecamatan' untuk menampilkan nama kecamatannya 
// 2. 'kelurahan' untuk menampilkan nama kelurahannya
// 3. 'both' untuk menampilkan keduanya
return ApiSamarinda::sekolah('kecamatan');
return ApiSamarinda::sekolah('kelurahan');
return ApiSamarinda::sekolah('both');

// Menampilkan seluruh data sekolah di Kota Samarinda berdasarkan jenjang pendidikannya
return ApiSamarinda::sekolahByJenjang('sd');
return ApiSamarinda::sekolahByJenjang('smp');
return ApiSamarinda::sekolahByJenjang('sma');
return ApiSamarinda::sekolahByJenjang('smk');

// Menampilkan seluruh data sekolah di Kota Samarinda berdasarkan status sekolah
return ApiSamarinda::sekolahByStatus('swasta');
return ApiSamarinda::sekolahByStatus('negeri');

// Menampilkan seluruh data sekolah di Kota Samarinda yang berlokasi di Kelurahan tertentu 
// Silahkan gunakan ID Kelurahan yang diinginkan
return ApiSamarinda::sekolahByKelurahan(6472030002);

// Menampilkan seluruh data sekolah di Kota Samarinda yang berlokasi di Kecamatan tertentu
// Silahkan gunakan ID Kecamatan yang diinginkan
return ApiSamarinda::sekolahByKecamatan(6472022);



// Contoh implementasi pada data yang ditarik menggunakan salah satu function diatas

// Untuk yang sifatnya List atau Array gunakan ini:
$data = ApiSamarinda::provinsi();
$array = (array)$data->original;
foreach($array['data'] as $temp) {
	return $temp['name'];
	// Output: Aceh
}

// Untuk yang sifatnya Individual atau Object gunakan ini:
$data = ApiSamarinda::provinsiById(64);
$array = (array)$data->original;
return $array['data']['name'];
// Output: Kalimantan Timur

Credit

License

API (Application Programming Interface) Samarinda is licensed under the MIT license for both personal and commercial products. Enjoy!

laravel-api-samarinda's People

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.