Google Maps dan geocoding

Buat dan konfigurasikan Kunci API Google Maps untuk Navixy On-Premise. Siapkan kunci terpisah untuk peta UI, layanan GIS, dan notifikasi email.

Untuk menggunakan Google Maps dengan Navixy On-Premise, Anda harus memperoleh Kunci API Google Maps yang valid. Halaman dokumentasi ini menyediakan panduan langkah demi langkah tentang cara membuat Kunci API Google Maps dan mengonfigurasikannya untuk digunakan dengan platform Navixy.

Panduan ini akan memandu Anda melalui proses menyiapkan akun Google Cloud Console, membuat proyek baru, menghasilkan Kunci API yang diperlukan, dan menerapkannya pada konfigurasi instance Navixy Anda. Dengan mengikuti panduan ini, Anda akan dapat dengan mudah mengintegrasikan Google Maps dengan Navixy On-Premise dan memanfaatkan sepenuhnya fitur pemetaan lanjutan platform.

Membuat Kunci API Google

Untuk membuat Kunci API Google yang digunakan dengan platform Navixy, silakan ikuti panduan di bawah ini. Perlu diketahui bahwa Kunci API Google terkait dengan akun Anda dan tunduk pada kebijakan penggunaan API Google. Untuk informasi lebih lanjut, silakan merujuk ke tautan di bawah ini:

• Ketentuan Layanan Google Maps APIs

• FAQ Google Maps

Menyiapkan akun dan proyek

1. Buka halaman Google Cloud Console dan masuk menggunakan kredensial akun Google Anda. Jika Anda belum memiliki akun, Anda dapat membuatnya.

2. Kunci API dibuat di dalam proyek. Jika Anda sudah memiliki proyek, Anda dapat memilihnya dari daftar. Jika Anda belum memiliki proyek apa pun, klik "Create project" untuk membuat yang baru.

3. Beri nama proyek Anda dengan tepat dan klik tombol "Create" untuk membuat proyek baru

1. Pastikan proyek yang baru Anda buat dipilih dan klik “Enable APIs and Services”. Anda akan diarahkan ke pustaka Google API.

2. Ketik nama API yang Anda perlukan, pilih, dan klik “Enable”. Dalam hal ini, kami menambahkan Maps JavaScript API (digunakan untuk Google Maps)

3. Ulangi proses tersebut untuk API yang Anda perlukan. Navixy menggunakan total 5 API:

• Google Maps JavaScript API - peta Google di UI

• Google Maps Geocoding API - Geocoding

• Google Maps Geolocation API - pemrosesan titik LBS

• Google Maps Directions API - pembuatan Rute

• Google Static Maps API - peta statis di email

Pastikan semua API yang diaktifkan ditampilkan di Dashboard Anda:

Membuat Kunci Google

Untuk mengaktifkan seluruh rangkaian fungsionalitas Navixy, Anda memerlukan total tiga Kunci API:

• Kunci #1 untuk menampilkan peta di antarmuka pengguna

• Kunci #2 untuk mengakses layanan GIS (geocoding, perutean, dan geolokasi)

• Kunci #3 untuk menampilkan peta statis Google Maps dalam notifikasi email

Membuat Kunci Google #1 untuk peta di antarmuka pengguna

1. Buka Credentials tab

2. Tekan Create credentials dan pilih API key

3. Kunci akan ditampilkan di jendela baru

4. Tekan Restrict key untuk melakukan perubahan, Anda akan diarahkan ke halaman penyiapan

5. Beri nama pada kunci agar lebih mudah dibedakan dari yang lain

6. Di Application restrictions pilih HTTP referrer dan tentukan domain yang Anda gunakan untuk platform. Misalnya contoso.com/* gps.contoso.com/*

7. Di API restrictions pilih Restrict key dan pilih Maps JavaScript API

8. Tekan Save untuk menerapkan perubahan

Membuat Kunci Google #2 untuk Geocoding, perutean, dan Geolokasi

1. Buka Credentials tab

2. Tekan Create credentials dan pilih API key

3. Kunci akan ditampilkan di jendela baru

4. Tekan Restrict key untuk melakukan perubahan, Anda akan diarahkan ke halaman penyiapan

5. Beri nama pada kunci agar lebih mudah dibedakan dari yang lain

6. Di Application restrictions pilih Alamat IP dan tentukan IP publik server Anda

7. Di API restrictions pilih Restrict key dan pilih Maps Geocoding API, Maps Geolocation API, Maps Directions API

8. Tekan Save untuk menerapkan perubahan

Membuat Kunci Google #3 untuk peta statis dalam notifikasi email

1. Buka Credentials tab

2. Tekan Create credentials dan pilih API key

3. Kunci akan ditampilkan di jendela baru

4. Tekan Restrict key untuk melakukan perubahan, Anda akan diarahkan ke halaman penyiapan

5. Beri nama pada kunci agar lebih mudah dibedakan dari yang lain

6. Di Application restrictions pilih HTTP referrer dan tentukan domain yang Anda gunakan untuk platform. Misalnya contoso.com/* gps.contoso.com/*

7. Di API restrictions pilih Restrict key dan pilih Maps Static API

8. Tekan Save untuk menerapkan perubahan

Untuk Kunci Google #3, Anda juga memerlukan URL signing secret. Silakan merujuk ke panduan di bawah untuk menghasilkan URL signing secret untuk Kunci peta statis Anda:

1. Buka Dashboard

2. Gulir ke bawah ke daftar API dan klik Maps Static API

3. Anda akan diarahkan ke halaman baru.

4. Klik pada Credentials menu

5. Periksa bahwa Maps Static API telah dipilih

6. Gulir ke bawah ke URL signing secret untuk melihat nilai saat ini.

Menerapkan Kunci API Google Maps

Seperti dijelaskan di atas, kami merekomendasikan untuk menghasilkan tiga Kunci API Google Maps dan menetapkan layanan Google API berikut kepada masing-masing:

Kunci API Google Maps #1 – harus dibatasi oleh HTTP referrer, yaitu URL antarmuka pengguna Anda:

• Google Maps JavaScript API

• Google Street View Image API

Kunci API Google Maps #2 – harus dibatasi oleh IP server:

• Google Maps Geocoding API

• Google Maps Geolocation API

• Google Maps Directions API

Kunci API Google Maps #3 – harus dibatasi oleh HTTP referrer, yaitu URL antarmuka pengguna Anda:

• Google Static Maps API (Anda juga memerlukan URL signing secret untuk kunci ini)

Ketiga kunci akan disimpan di basis data. Kunci-kunci tersebut harus dimasukkan ke dalam tabel dealer_service_credentials di google DB dengan kueri berikut:

INSERT INTO dealer_service_credentials (dealer_id, service_type,credentials) VALUES (1, 'google', '{"maps_js_api_key":"FIRST_KEY_HERE","server_api_key":"SECOND_KEY_HERE","static_map_api_key":"THIRD_KEY_HERE", "static_map_crypto_key":"URL_SIGNING_SECRET_HERE"}';

Jika Anda tidak ingin menggunakan Google Maps untuk layanan tertentu, Anda dapat menghilangkan kunci yang tidak Anda perlukan dari kueri. Misalnya, gunakan kueri ini untuk menerapkan hanya kunci ketiga:

INSERT INTO google.dealer_service_credentials (dealer_id, service_type, credentials) VALUES (1, "google", '{"static_map_api_key":"THIRD_KEY_HERE", "static_map_crypto_key":"URL_SIGNING_SECRET_HERE"}');

Mulai ulang layanan

restart-navixy