# 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](https://developers.google.com/maps/terms)
* [FAQ Google Maps](https://developers.google.com/maps/faq)

### Menyiapkan akun dan proyek

1. Arahkan ke [Google Cloud Console](https://console.cloud.google.com/projectselector2/apis/dashboard?supportedpurview=project) 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

![](/files/534bb3969b607379a7018c00224be56bfe70215b)

![](/files/76b70744c70ed5b7b6be3d9963cff41af4002903)

4. Pastikan proyek yang baru dibuat dipilih dan klik “Enable APIs and Services”. Anda akan dibawa ke perpustakaan API Google.
5. Ketik nama API yang Anda butuhkan, pilih itu dan klik “Enable”. Dalam hal ini kita menambahkan Maps Javascript API (digunakan untuk google maps)
6. 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

![](/files/9d5eb9f1d2f74e497c9097633412e47253c5155a)

![](/files/23eefac30d733d9126c6fd2cc685dd6a791b6fec)

![](/files/329479cdfb69d27ebc89ef307b9d908122bf76cc)

Pastikan semua API yang diaktifkan ditampilkan di dasbor Anda:

![](/files/945708fcdae6bdb7f09c6dee8096b9c53d752880)

### 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/\*](http://contoso.com/*) [gps.contoso.com/\*](http://gps.contoso.com/*)
7. Dalam *API restrictions* pilih *Restrict key* dan pilih Maps JavaScript API
8. Tekan *Save* untuk menerapkan perubahan

![](/files/01ed777cb4785cd8ff72e95f29aceec6418a286f)

![](/files/f7467262278a75f0d6981e980dd3349bcbe3366e)

![](/files/d0b3dc9f195248a22f628184a4f8e3f9ab47a08f)

![](/files/04725ea125174ffafc38d4fb3508dc047001b636)

![](/files/afe7de5d9693058c62ba7dfdfcc74a97ac7dc71f)

#### 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

![](/files/8e2592976f62d30f55d91ac096d9ea4198c427a6)

![](/files/7d3c7f20bbca7a79cd8130ecb05993123ae9e958)

![](/files/db3a34dbd91f29c2839428efd046ac1b717ca344)

![](/files/e2425c93b90fddd59a43b23b103b73da6d3288f7)

![](/files/d75b25eec29f12f56706e261e4f7c8c1d2ef9a2d)

#### **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/\*](http://contoso.com/*) [gps.contoso.com/\*](http://gps.contoso.com/*)
7. Dalam *API restrictions* pilih *Restrict key* dan pilih Maps Static API
8. Tekan *Save* untuk menerapkan perubahan

![](/files/3a2a754aba4fb8e0430e6e94632f0bb1b59c8e99)

![](/files/e371e24aae5d9f85a524a942981b7eb9b5a879d5)

![](/files/5e110b5dbfced2dc4abed2f889e2bbf0f30b9b3a)

![](/files/44affd5a2a45b37881a58f47a4ea0e6a740396a4)

![](/files/4fb5639b2d20a5bf1739d445859f7869ee72f83e)

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.

![](/files/a9ea0abe7e4f426a0a9bd4c57de2c9e70b85b656)

![](/files/b623d775e9efe1bf4965637e3c5e2165bbac5b3d)

## 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:

{% code overflow="wrap" %}

```
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"}';
```

{% endcode %}

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:

{% code overflow="wrap" %}

```
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"}');
```

{% endcode %}

**Restart the services**

`restart-navixy`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://navixy.com/docs/on-premise/id/on-premise/how-to-guide/configuration/maps-and-gis/google-maps-and-geocoding.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.