Google maps dan geocoding

Untuk menggunakan Google Maps dengan Navixy On-premise, Anda harus memperoleh kunci API Google Maps yang valid. Halaman dokumentasi ini memberikan panduan langkah demi langkah tentang cara membuat kunci API Google Maps dan mengonfigurasinya 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 ke 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 canggih dari platform.

Membuat kunci Google API

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

• Ketentuan Layanan Google Maps

• FAQ Google Maps

Menyiapkan akun dan proyek

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

2. Kunci API dibuat dalam sebuah proyek. Jika Anda sudah memiliki proyek, Anda dapat memilihnya dari daftar. Jika Anda tidak memiliki proyek yang ada, klik "Create project" untuk membuat proyek baru.

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

1. Pastikan proyek yang baru dibuat dipilih dan klik “Enable APIs and Services”. Anda akan dibawa ke perpustakaan API Google.

2. Ketik nama API yang Anda butuhkan, pilih itu dan klik “Enable”. Dalam hal ini kita menambahkan Maps Javascript API (digunakan untuk google maps)

3. Ulangi proses untuk API yang Anda butuhkan. Navixy memanfaatkan total 5 API:

• Google Maps JavaScript API - Google maps di antarmuka pengguna

• Google Maps Geocoding API - Geocoding

• Google Maps Geolocation API - Pemrosesan titik LBS

• Google Maps Directions API - Pembuatan rute

• Google Static Maps API - Peta statis dalam email

Pastikan semua API yang diaktifkan ditampilkan di dasbor Anda:

Menghasilkan kunci Google

Untuk mengaktifkan seluruh rangkaian fungsionalitas Navixy, Anda akan membutuhkan total tiga kunci API:

• Kunci #1 untuk menampilkan peta di antarmuka pengguna

• Kunci #2 untuk mengakses layanan GIS (geocoding, routing, dan geolocation)

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

Menghasilkan kunci Google #1 untuk Maps di UI

1. Pergi ke Credentials tab

2. Tekan Create credentials dan pilih API key

3. Kunci akan ditampilkan di jendela baru

4. Tekan Restrict key untuk membuat perubahan, Anda akan dibawa ke halaman pengaturan

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

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

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

8. Tekan Save untuk menerapkan perubahan

Menghasilkan Kunci Google #2 untuk Geocoding, Routing dan Geolocation

1. Pergi ke Credentials tab

2. Tekan Create credentials dan pilih API key

3. Kunci akan ditampilkan di jendela baru

4. Tekan Restrict key untuk membuat perubahan, Anda akan dibawa ke halaman pengaturan

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

6. Dalam Application restrictions pilih IP adresses dan tentukan IP publik server Anda

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

8. Tekan Save untuk menerapkan perubahan

Menghasilkan Kunci Google #3 untuk peta statis dalam notifikasi email

1. Pergi ke Credentials tab

2. Tekan Create credentials dan pilih API key

3. Kunci akan ditampilkan di jendela baru

4. Tekan Restrict key untuk membuat perubahan, Anda akan dibawa ke halaman pengaturan

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

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

7. Dalam 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 Static maps Anda:

1. Pergi ke Dashboard

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

3. Anda akan diteruskan ke halaman baru.

4. Klik pada Credentials menu

5. Periksa bahwa Maps Static API dipilih

6. Gulir ke bawah ke URL signing secret untuk melihat yang saat ini Anda miliki.

Menerapkan kunci Google Maps API

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

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

• Google Maps JavaScript API

• Google Street View Image API

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

• Google Maps Geocoding API

• Google Maps Geolocation API

• Google Maps Directions API

Kunci Google Maps API #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 database. Mereka harus dimasukkan ke dalam tabel dealer_service_credentials dari google DB dengan query 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 butuhkan dari query. Sebagai contoh, gunakan query 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"}');

Restart the services

restart-navixy