این محصول یا ویژگی در وضعیت Legacy است. For more information about Legacy status and how to migrate from Legacy to newer services, see
Legacy products and features .
نمای کلی Directions API (Legacy).
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
توسعه دهندگان منطقه اقتصادی اروپا (EEA). 
Directions API (Legacy) سرویسی است که درخواست HTTP را می‌پذیرد و مسیرهای با قالب JSON یا XML را بین مکان‌ها برمی‌گرداند.
چرا از Directions API استفاده کنید
با Directions API، می‌توانید برای چندین حالت حمل‌ونقل مانند حمل‌ونقل، رانندگی، پیاده‌روی یا دوچرخه‌سواری مسیرها را دریافت کنید.
با Directions API چه کاری می توانید انجام دهید؟
با Directions API، می‌توانید جهت‌ها را بین مکان‌ها محاسبه کنید، از جمله جزئیات زیر:
- دستورالعمل برای چندین روش حمل و نقل، از جمله حمل و نقل، رانندگی، پیاده روی یا دوچرخه سواری.
- جهت های چند بخشی با استفاده از یک سری از ایستگاه های بین راه.
- مبدا، مقصد، و نقاط راه را به روش‌های مختلف، از جمله به‌عنوان رشته‌های متنی (مثلاً «Chicago, IL» یا «Darwin, NT, Australia»)، شناسه‌های مکان یا مختصات طول و عرض جغرافیایی مشخص کنید.
نحوه عملکرد Directions API
Directions API کارآمدترین مسیرها را هنگام محاسبه جهت ها برمی گرداند. عوامل محصول در عناصر سفر زیر هنگام تعیین کارآمدترین مسیر:
- زمان سفر (اولیه)
- فاصله
- تعداد نوبت
درخواست مثال زیر مسیرهای رانندگی از تورنتو، انتاریو به مونترال، کبک را در قالب JSON برمی گرداند:
https://maps.googleapis.com/maps/api/directions/json
?destination=Montreal
&origin=Toronto
&key=YOUR_API_KEY
منابع
جدول زیر منابع موجود از طریق Directions API را به همراه داده هایی که برمی گرداند خلاصه می کند.
| منابع داده | داده ها برگردانده شد | فرمت بازگشت |
|---|
| مسیرها مبدا و مقصد را به شکل شناسه مکان، آدرس، یا مختصات طول و عرض جغرافیایی ارائه دهید. برای جزئیات بیشتر به پارامترهای مورد نیاز مراجعه کنید. | مسیرهای دقیق، به مسیرها، پاها و مراحل تقسیم شده است. برای جزئیات بیشتر به پاسخ‌های دستورالعمل‌ها مراجعه کنید. | |
نحوه استفاده از Directions API
| 1 | راه اندازی شود. | با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های راه‌اندازی را تکمیل کنید. |
| 2 | نسخه ی نمایشی را امتحان کنید | هنگامی که یک کلید API و یک پروژه ابری دارید، نسخه ی نمایشی مسیرها را بدون پرداخت هزینه امتحان کنید. نسخه ی نمایشی API Directions را ببینید. |
| 3 | درخواست بسازید | نمونه درخواست‌ها را ببینید و در مورد گزینه‌های موجودی که می‌توانید ارائه کنید، مانند حالت‌های سفر، ایستگاه‌های بین راه، و محدودیت‌های مسیر، اطلاعات کسب کنید. نمونه‌های دستورالعمل‌ها را ببینید. |
| 4 | اصول پاسخگویی را درک کنید | برای آماده شدن برای استفاده از داده های مسیرها برای برنامه خود، پاسخ های داده را کاوش کنید. برای جزئیات بیشتر به پاسخ‌های دستورالعمل‌ها مراجعه کنید. |
| 5 | داده های جهت را در برنامه خود بگنجانید! | می توانید از این داده ها برای محاسبه مسافت و زمان سفر استفاده کنید. |
کتابخانه های مشتری موجود
این API را به زبان انتخابی خود از طریق یکی از کتابخانه های سرویس گیرنده زیر فراخوانی کنید:
Java Client، Python Client، Go Client و Node.js Client برای سرویس‌های Google Maps، کتابخانه‌های مشتری پشتیبانی شده توسط جامعه هستند که تحت مجوز Apache 2.0 منبع باز هستند. آنها را از GitHub دانلود کنید، جایی که می توانید دستورالعمل های نصب و کد نمونه را پیدا کنید.
بعدش چی
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی."],[[["\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)."]]
