این محصول یا ویژگی در وضعیت Legacy است. برای اطلاعات بیشتر در مورد مرحله Legacy و نحوه انتقال از Legacy به سرویسهای جدیدتر، به
محصولات و ویژگیهای Legacy مراجعه کنید.، این محصول یا ویژگی در وضعیت Legacy است. برای اطلاعات بیشتر در مورد مرحله Legacy و نحوه انتقال از Legacy به سرویسهای جدیدتر، به
محصولات و ویژگیهای Legacy مراجعه کنید.، این محصول یا ویژگی در وضعیت Legacy است. برای اطلاعات بیشتر در مورد مرحله Legacy و نحوه انتقال از Legacy به سرویسهای جدیدتر، به
محصولات و ویژگیهای Legacy مراجعه کنید.، این محصول یا ویژگی در وضعیت Legacy است. برای اطلاعات بیشتر درباره مرحله Legacy و نحوه انتقال از Legacy به سرویسهای جدیدتر، به
محصولات و ویژگیهای Legacy مراجعه کنید.
با Distance Matrix API شروع کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
نمونه درخواست و پاسخ
این مثال دادههای ماتریس فاصله بین واشنگتن دی سی و نیویورک سیتی، نیویورک را در قالب JSON درخواست میکند:
آدرس اینترنتی
https://maps.googleapis.com/maps/api/distancematrix/json
?destinations=New%20York%20City%2C%20NY
&origins=Washington%2C%20DC
&units=imperial
&key=YOUR_API_KEY
حلقه
curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Washington%2C%20DC&destinations=New%20York%20City%2C%20NY&units=imperial&key=YOUR_API_KEY'
امتحانش کن! این درخواست را با وارد کردن URL در مرورگر وب خود امتحان کنید - حتماً YOUR_API_KEY با کلید API واقعی خود جایگزین کنید. پاسخ، فاصله و مدت زمان بین مبدا و مقصد مشخص شده را نشان میدهد.
یاد بگیرید که چگونه URL های درخواستی، شامل تمام پارامترهای موجود، را بسازید .
این نمونه کد در قالبهای JSON و XML است:
جیسون
{
"destination_addresses": ["New York, NY, USA"],
"origin_addresses": ["Washington, DC, USA"],
"rows":
[
{
"elements":
[
{
"distance": { "text": "228 mi", "value": 367654 },
"duration": { "text": "3 hours 55 mins", "value": 14078 },
"status": "OK",
},
],
},
],
"status": "OK",
} XML
<DistanceMatrixResponse>
<status>OK</status>
<origin_address>Washington, DC, USA</origin_address>
<destination_address>New York, NY, USA</destination_address>
<row>
<element>
<status>OK</status>
<duration>
<value>14078</value>
<text>3 hours 55 mins</text>
</duration>
<distance>
<value>367654</value>
<text>228 mi</text>
</distance>
</element>
</row>
</DistanceMatrixResponse> برای درک پاسخ، راهنمای توسعهدهنده را بررسی کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-11-02 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-11-02 بهوقت ساعت هماهنگ جهانی."],[],["The content demonstrates requesting distance data between Washington, DC, and New York City using the Google Maps Distance Matrix API. The request URL and cURL command are provided, requiring the user to replace `YOUR_API_KEY` with their own. The API returns distance (228 mi) and duration (3 hours 55 mins) data in both JSON and XML formats. Users can test the URL and further understand responses, and can learn to build custom URL requests through provided documentation.\n"]]