Produk atau fitur ini berstatus Lama. Untuk mengetahui informasi selengkapnya tentang status Lama dan cara bermigrasi dari layanan Lama ke layanan yang lebih baru, lihat
Produk dan fitur lama.
Ringkasan Directions API (Lama)
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Developer Wilayah Ekonomi Eropa (EEA)
Directions API (Lama) adalah layanan yang menerima permintaan HTTP dan menampilkan petunjuk arah berformat JSON atau XML antar-lokasi.
Alasan menggunakan Directions API
Dengan Directions API, Anda bisa mendapatkan rute untuk beberapa moda transportasi, seperti transportasi umum, mengemudi, jalan kaki, atau bersepeda.
Apa yang dapat Anda lakukan dengan Directions API?
Dengan Directions API, Anda dapat menghitung rute antar-lokasi, termasuk detail berikut:
- Rute untuk beberapa moda transportasi, termasuk transportasi umum, mengemudi, berjalan kaki, atau bersepeda.
- Rute multi-bagian menggunakan serangkaian titik jalan.
- Tentukan asal, tujuan, dan titik jalan dalam berbagai cara, termasuk sebagai
string teks (misalnya, "Chicago, IL" atau "Darwin, NT, Australia"), ID tempat, atau koordinat lintang/bujur.
Cara kerja Directions API
Directions API menampilkan rute yang paling efisien saat menghitung rute. Produk ini mempertimbangkan elemen perjalanan berikut
saat menentukan rute yang paling efisien:
- Waktu tempuh (utama)
- Jarak
- Jumlah putaran
Contoh permintaan berikut menampilkan petunjuk arah mengemudi dari Toronto, Ontario ke Montreal, Quebec dalam format JSON:
https://maps.googleapis.com/maps/api/directions/json
?destination=Montreal
&origin=Toronto
&key=YOUR_API_KEY
Resource
Tabel berikut merangkum resource yang tersedia melalui
Directions API beserta data yang ditampilkan.
| Resource data |
Data yang ditampilkan |
Format pengembalian |
| Directions
Berikan tempat asal dan tujuan dalam bentuk ID tempat, alamat,
atau koordinat lintang/bujur. Lihat parameter wajib
untuk mengetahui detailnya.
|
Petunjuk arah yang mendetail, yang dibagi menjadi rute, segmen, dan langkah. Lihat
Respons petunjuk arah untuk mengetahui detailnya.
|
|
Cara menggunakan Directions API
| 1 |
Lakukan penyiapan. |
Mulai dengan Menyiapkan project Google Cloud dan selesaikan petunjuk penyiapan berikutnya. |
| 2 |
Coba demo |
Setelah memiliki kunci API dan project cloud, Anda dapat mencoba
demo petunjuk arah tanpa biaya. Lihat Demo Directions API.
|
| 3 |
Buat permintaan |
Lihat contoh permintaan dan pelajari opsi yang tersedia yang dapat Anda berikan, seperti mode perjalanan, titik jalan, dan batasan rute. Lihat Contoh petunjuk arah.
|
| 4 |
Memahami dasar-dasar respons |
Jelajahi respons data untuk bersiap menggunakan data rute untuk aplikasi Anda. Lihat
Respons rute
untuk mengetahui detailnya.
|
| 5 |
Sertakan data arah ke dalam aplikasi Anda sendiri. |
Anda dapat menggunakan data ini untuk menghitung jarak dan waktu perjalanan.
|
Library klien yang tersedia
Panggil API ini dalam bahasa pilihan Anda melalui salah satu library klien berikut:
Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Layanan Google Maps adalah library klien yang didukung komunitas, yang bersifat open source berdasarkan Lisensi Apache 2.0.
Download library tersebut dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.
Langkah berikutnya
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-31 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-31 UTC."],[[["\u003cp\u003eThe Directions API provides route information between locations using various transportation modes like driving, walking, transit, or bicycling.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize your requests by specifying origins, destinations, waypoints, and travel preferences.\u003c/p\u003e\n"],["\u003cp\u003eThe API calculates the most efficient routes based on travel time, distance, and the number of turns.\u003c/p\u003e\n"],["\u003cp\u003eResults are available in JSON or XML format and include detailed directions, routes, legs, and steps.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries are available in Java, Python, Go, and Node.js for easy integration into your applications.\u003c/p\u003e\n"]]],[],null,["# Directions API (Legacy) overview\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nThe Directions API (Legacy) is a service that accepts an HTTP request and returns JSON or XML-formatted directions between locations.\n\nWhy use the Directions API\n--------------------------\n\nWith the Directions API, you can get directions for several modes of\ntransportation, such as transit, driving, walking, or bicycling.\n\nWhat you can do with the Directions API?\n----------------------------------------\n\nWith the Directions API, you can calculate directions between locations,\nincluding the following details:\n\n- Directions for several modes of transportation, including transit, driving, walking or bicycling.\n- Multipart directions using a series of waypoints.\n- Specify origins, destinations, and waypoints in multiple ways, including as text strings (for example, \"Chicago, IL\" or \"Darwin, NT, Australia\"), place IDs, or latitude/longitude coordinates.\n\nHow the Directions API works\n----------------------------\n\nThe Directions API returns the most efficient routes when\ncalculating directions. The product factors in the following travel elements\nwhen determining the most efficient route:\n\n- Travel time (primary)\n- Distance\n- Number of turns\n\nThe following example request returns driving directions from Toronto, Ontario to Montreal, Quebec in JSON format: \n\n```scdoc\nhttps://maps.googleapis.com/maps/api/directions/json\n ?destination=Montreal\n &origin=Toronto\n &key=YOUR_API_KEY\n```\n\n### Resources\n\nThe following table summarizes the resources available through the\nDirections API along with the data it returns.\n\n\u003cbr /\u003e\n\n| Data resources | Data returned | Return format |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| [Directions](/maps/documentation/directions/get-directions#DirectionsRequests) Supply origins and destinations in the form of place IDs, addresses, or latitude/longitude coordinates. See [required parameters](/maps/documentation/directions/get-directions#required-parameters) for details. | Detailed directions, broken into routes, legs, and steps. See [Directions responses](/maps/documentation/directions/get-directions#DirectionsResponses) for details. | - JSON - XML |\n\n\u003cbr /\u003e\n\nHow to use the Directions API\n-----------------------------\n\n|---|---------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up.** | Start with [Set up your Google Cloud project](/maps/documentation/directions/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Try the demo** | Once you have an API key and a cloud project you try out the directions demo at no charge. See [The Directions API demo](/maps/documentation/directions/start). |\n| 3 | **Build a request** | See the example requests and learn about the available options you can supply, such as travel modes, waypoints, and route restrictions. See [Directions examples](/maps/documentation/directions/get-directions#ExampleRequests). |\n| 4 | **Understand response basics** | Explore the data responses to prepare to use directions data for your app. See [Directions responses](/maps/documentation/directions/get-directions#DirectionsResponses) for details. |\n| 5 | **Incorporate direction data into your own app!** | You can use this data to calculate travel distance and time. |\n\n#### Available client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n-----------\n\n- **Start using the Directions API** : Go to [Get started](/maps/documentation/directions/start).\n- **Start making Directions requests** : Go to [Get\n directions](/maps/documentation/directions/get-directions).\n- **Follow best practices** : Go to [Web service best\n practices](/maps/documentation/directions/web-service-best-practices)."]]
