方向 API

获取两个地点之间的详细路线,包括距离、时间和步骤,方便导航和高效的旅行规划
通过 MCP 从您的 AI 代理使用此 API
支持 OpenClaw、Claude Code/Desktop、Cursor、Windsurf、Cline 以及任何兼容 MCP 的 AI 客户端。
文档和设置
通过封装此 MCP 创建技能: https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY

关于API: 

方向API允许用户访问地点之间的详细路线信息。通过利用此API,用户可以获取各种交通方式的准确方向。这一功能不仅增强了用户体验,还促进了需要导航功能的应用程序的开发。

该API通过获取一组起点和终点坐标并处理请求来返回完整的地址数据。这包括预计的距离和旅行时间,这对于用户规划行程至关重要。此信息的准确性因API能够考虑实时交通状况而大大增强,确保用户获得最有效的路线。这个功能在城市环境中尤其重要,因为交通可能不可预测并显著影响旅行时间。

总的来说,方向API是希望在其应用中实现导航功能的用户的重要资源。它提供准确、详细和高效的路线信息,增强了用户体验,并帮助用户创建更具吸引力和实用性的应用程序。

API 文档

端点


要使用此端点,您必须在参数中指定出发地和目的地



                                                                            
GET https://zylalabs.com/api/5157/%e6%96%b9%e5%90%91+api/6578/%e8%8e%b7%e5%8f%96%e8%b7%af%e7%ba%bf
                                                                            
                                                                        

获取路线 - 端点功能

对象 描述
origin [必需] Indicates an origin
destination [必需] Indicates an destination.
测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {
   "geocoded_waypoints" : 
   [
      {
         "geocoder_status" : "OK",
         "partial_match" : true,
         "place_id" : "ChIJzzgyJU--woARcZqceSdQ3dM",
         "types" : 
         [
            "amusement_park",
            "establishment",
            "point_of_interest",
            "tourist_attraction"
         ]
      },
      {
         "geocoder_status" : "OK",
         "partial_match" : true,
         "place_id" : "ChIJg3XXhNrX3IARUc0M9bIC_X4",
         "types" : 
         [
            "amusement_park",
            "establishment",
            "lodging",
            "point_of_interest"
         ]
      }
   ],
   "routes" : 
   [
      {
         "bounds" : 
         {
            "northeast" : 
            {
               "lat" : 34.13621000000001,
               "lng" : -117.9223126
            },
            "southwest" : 
            {
               "lat" : 33.8178372,
               "lng" : -118.3526957
            }
         },
         "copyrights" : "Map data ©2024 Google",
         "legs" : 
         [
            {
               "distance" : 
               {
                  "text" : "34.9 mi",
                  "value" : 56214
               },
               "duration" : 
               {
                  "text" : "48 mins",
                  "value" : 2904
               },
               "end_address" : "Anaheim, CA 92802, USA",
               "end_location" : 
               {
                  "lat" : 33.8178372,
                  "lng" : -117.9223126
               },
               "start_address" : "100 Universal City Plaza, Universal City, CA 91608, USA",
               "start_location" : 
               {
                  "lat" : 34.1345191,
                  "lng" : -118.3514579
               },
               "steps" : 
               [
                  {
                     "distance" : 
                     {
                        "text" : "486 ft",
                        "value" : 148
                     },
                     "duration" : 
                     {
                        "text" : "1 min",
                        "value" : 19
                     },
                     "end_location" : 
                     {
                        "lat" : 34.1358101,
                        "lng" : -118.3511704
                     },
                     "html_instructions" : "Head \u003cb\u003enortheast\u003c/b\u003e on \u003cb\u003eUniversal Studios Blvd\u003c/b\u003e",
                     "polyline" : 
                     {
                        "points" : "w{ioErojqUGEECGCGCGCGCGCKCICEACACAIAEAGAIAGAGAG?IAQCM@I@i@@OA"
                     },
                     "start_location" : 
                     {
                        "lat" : 34.1345191,
                        "lng" : -118.3514579
                     },
                     "travel_mode" : "DRIVING"
                  },
                  {
                     "distance" : 
                     {
                        "text" : "0.3 mi",
                        "value" : 450
                     },
                     "duration" : 
                     {
                        "text" : "2 mins",
                        "value" : 135
                     },
                     "end_location" : 
                     {
                        "lat" : 34.1329768,
                        "lng" : -118.3526957
                     },
                     "html_instructions" : "Make a \u003cb\u003eU-turn\u003c/b\u003e",
                     "maneuver" : "uturn-left",
                     "polyline" : 
                     {
                        "points" : "ycjoExmjqUYCA?E?E?A?E@CBC@CBC@A@CBCBCB?@AB?@?@?@?@?@?@@@?@@@@@@@@?BB@?@?@?@?@?@AB?@??AB?@?ZGJCZ?TCPC@?T?B?F?H?PB@?PBLBLJFFHDJBNFFDNFHFJFTPj@^PL`@Xh@\\NJPJTJTJPHNDLDHB"
                     },
                     "start_location" : 
                     {
                        "lat" : 34.1358101,
                        "lng" : -118.3511704
                     },
                     "travel_mode" : "DRIVING"
                  },
                  {
                     "distance" : 
                     {
                        "text" : "9.6 mi",
                        "value" : 15489
                     },
                     "duration" : 
                     {
                        "text" : "17 mins",
                        "value" : 996
                     },
                     "end_location" : 
                     {
                        "lat" : 34.0525166,
                        "lng" : -118.2258658
                     },
                     "html_instructions" : "Turn \u003cb\u003eleft\u003c/b\u003e to merge onto \u003cb\u003eUS-101 S\u003c/b\u003e",
                     "maneuver" : "ramp-left",
                     "polyline" : 
                     {
                        "points" : "crioEjwjqU\\[Hc@Fa@@KJe@DOFU@CHUDK?A@AJWFOJQBIVe@\\m@BANUHMNS@A?ACi@NOVWRUTURSHKDETUJMFGRSRURSPSFGLMRSPSPQNOBEBCPQBCPQRSNQDCJMDEPQFGNOPSJIHKRSRS@APQLODCBCBEJKLKBEFELOPQ@?TYVWVWTUTWZ[JKXYDELMPQTWTUDCJIXSXSFE^W\\WHGLGNId@WPKVQJEBCHCLIHGXQRMBCLITQFENMLK\\WZY@ALMTWJM@ARWNORWx@cAX]NSZ_@`@i@Z]V]x@aANS@Cd@k@RUZ_@\\_@T[FGb@e@RQLMBELK\\]JKl@k@PQLKJGHGNKBCDEJG^YTOzAcAn@c@VMVMVMXOh@U`@QRIPGZMHCLE^OVIFC@?^MVI`@KHAf@IVEd@ITEd@ILCFAb@GZGXELCHAXGXElAS|@On@INAv@MXGZEXGVGXGXGd@KJEXILCHEXIXIv@W\\OPIDAVKTKXOXOJEJENKPI^SVORMVOHGJIVQTQb@[FERURU?APQPSTWRURUPWPUPYPWXg@BEFMHONYNYLYNYNY@C\\o@LY^s@LYNWNYN[LYNWP_@P]HQ\\o@nAeCJSNYN[NYLYNYNYR_@HQHQr@sAP_@z@cBp@uABE\\o@LWNYLYN[N]Z{@FSFQNe@H]H[Jc@DWF_@F]D_@D]F_@@]@]@]?C@_@B_@@]?Q@s@?i@@i@?W?[@cA@a@@[?M@Q@O@OB_@D_@B]Fa@D]F]H_@F]FQ@KJ[H]J[N_@JYJYN[LYNY^q@h@u@RYPUTURSRSRSTQXUTQRMp@]bAg@~Aw@tBeArBcAZQVMTKZORKTMXMTK@Al@YXOFCHE\\QTMNIFCTOTOVOTOTQTQROTQDEx@u@DELKRURSRUPSRUPUPWRUPUPWNUPYLYPWLYPYNYLWR_@n@iAJSP[NWLWP[LUPYLWNYNYLSBGf@_ADGNWNYJQBEPWPUPWPUFGJMRURQPS`@]HITQTQXQTOTMTOp@[j@[HEpAq@dAi@jDiBx@a@^SPIZSn@a@VQh@_@d@a@r@o@p@o@VYTUPSRURWPUXa@Xa@V]JQNWR[Ta@FK^m@t@mA~@}Ah@}@Xc@h@{@b@u@HOT]Ta@\\i@j@_Av@oAFMJO^m@FKZg@LSPYFIHMNUPWRYLSNQNUT]j@w@T]NULSNWLWNUN[@ENYHQL[JS@Et@kB@EJYL]JY@GHSJ[JYJ[L]L]BGJYFQL[LYRg@JURa@Re@JQBEFOHQBGFOP[DMDG\\q@JWP[BGHSL[LW?ABEHUVy@@C@EPk@Ja@F[Ha@FWBMBQF]D_@B[D_@D]B_@@YBc@@Q?GBc@@a@?IBg@@K@_@@]Ba@@c@Bc@Bc@@]?EB]@SBSBYB[@QBQBYDa@BOLiA@IJq@PsAF_@Lw@Fa@RwAL_AD[Fe@ZwBZuBD]BOBOBO@QDUDUD[F]D]F]Jg@Ji@@GJi@?CDQ?CDMTqABMH]DWZ_BF[Hg@VqAF[FY`@yBFW`@uBLq@VuANw@BINs@BKJc@VeAH[Rs@T{@^kAZ{@@ENa@@EL[h@uAz@uBRe@L_@L[d@wA`@mAFSDOFUJ]v@gC`@oA^mAL]Vw@Pi@FOJYTo@zAqEr@wBTo@DOZy@r@yBHWd@gBd@kBPs@V_AXkALi@ZmAPs@Ja@VeALc@DMf@sBh@wBH]J_@Nm@BKHWBOZkADUPq@J[R}@J]DOBKDQBIHWX}@?AHQPi@JWHUBE\\w@BGBILUFQBERc@NYJOXe@l@aAXc@\\i@Xc@l@}@\\k@BGJOT_@\\i@NULSFKFILS\\k@NUR]HKLUXc@FI^k@Zi@PWDGDGRU^e@DCRUNOJIPQ\\Yz@q@l@g@f@a@VSHGVUp@i@XWNKNMt@m@VSJIJK@?HIh@a@RQNMLKJIHGTSTUv@y@HKX[\\_@\\c@f@m@f@o@fA{An@{@b@o@x@mAn@eAZg@PYNWx@uAj@gAl@gA\\q@Ve@Xg@dAqBTa@DKHMFKFMBCRa@NYNYTc@`@u@Ta@R_@@CJST_@LYNYj@eAVi@FMFQFKDMVq@FO?AJ]FQ@IH[Fa@J{@@CBW@[?C@W@U@i@?_@@y@@u@?Y@q@?k@BcA@YD}AD}AFyBBsADu@?EJyA@GB]?KBYBYDg@Bi@@A\\kE@MV}CLyAHo@B_@Fm@LqANuAJgABWDi@@C@SBY"
                     },
                     "start_location" : 
                     {
                        "lat" : 34.1329768,
                        "lng" : -118.3526957
                     },
                     "travel_mode" : "DRIVING"
                  },
                  {
                     "distance" : 
                     {
                        "text" : "2.3 mi",
                        "value" : 3669
                     },
                     "duration" : 
                     {
                        "text" : "2 mins",
                        "value" : 143
                     },
                     "end_location" : 
                     {
                        "lat" : 34.026525,
                        "lng" : -118.2089504
                     },
                     "html_instructions" : "Keep \u003cb\u003eright\u003c/b\u003e to stay on \u003cb\u003eUS-101 S\u003c/b\u003e",
                     "maneuver" : "keep-right",
                     "polyline" : 
                     {
                        "points" : "g{ynEt~qpUFS@GBOHa@@IDSDYFQDOTw@@EL]b@_ABEFMBGFIHKFMPURUHITWHIJIFGJIHGNKHGPKpAk@jAe@PGXMbAa@DAjAe@vAk@j@SXKJEf@MPGt@UPELCb@K^GPCZEVE`@Gr@GFANAl@ERAPAZAj@A`AAB?NAF?j@ApAAP?VAjAAj@AjAAnADN?j@Dv@Fj@DTBpANhANJ@t@J`@F\\DNBd@Dv@FT@R@Z?L?d@?NA^AJ?l@Et@Gh@CL?`@?B?L?`@@n@B^@\\DN@ZB|@Jd@DF?L@X@P?^@B?|@Cd@Ex@I\\Gv@Or@QBAZK@?HEDANGBAhB{@b@WXULKdByABAVUJMh@g@VYTWRSNSPSLOPS?ATYPWNSJO\\g@NUJQRYJSLUP[LSJSJUJQFOTc@Xo@JUFQp@wANe@Ri@pA}DdA{CNe@Z{@HWFOX{@`@mAn@kBn@mBPg@Vw@d@wADKb@oAL_@HYXw@DKHYXy@L]HW@??AVM"
                     },
                     "start_location" : 
                     {
                        "lat" : 34.0525166,
                        "lng" : -118.2258658
                     },
                     "travel_mode" : "DRIVING"
                  },
                  {
                     "distance" : 
                     {
                        "text" : "22.0 mi",
                        "value" : 35436
                     },
                     "duration" : 
                     {
                        "text" : "25 mins",
                        "value" : 1487
                     },
                     "end_location" : 
                     {
                        "lat" : 33.8261327,
                        "lng" : -117.9260045
                     },
                     "html_instructions" : "Merge onto \u003cb\u003eI-5 S\u003c/b\u003e",
                     "maneuver" : "merge"}]}]}],"_note":"Response truncated for documentation purposes"}
                                                                                                                                                                                                                    
                                                                                                    

获取路线 - 代码片段


curl --location --request GET 'https://zylalabs.com/api/5157/%e6%96%b9%e5%90%91+api/6578/%e8%8e%b7%e5%8f%96%e8%b7%af%e7%ba%bf?origin=Universal Studios Hollywood&destination=Disneyland' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 方向 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
标头
标头 描述
授权 [必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

简单透明的定价

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

🚀 企业版

起价
$ 10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

客户喜爱的功能

  • ✔︎ 仅支付成功请求
  • ✔︎ 7 天免费试用
  • ✔︎ 多语言支持
  • ✔︎ 一个 API 密钥,所有 API。
  • ✔︎ 直观的仪表板
  • ✔︎ 全面的错误处理
  • ✔︎ 开发者友好的文档
  • ✔︎ Postman 集成
  • ✔︎ 安全的 HTTPS 连接
  • ✔︎ 可靠的正常运行时间

方向 API FAQs

要使用此API,用户必须指定源和目标

有不同的计划适合每个人,包括免费试用

方向API允许您计算路线获取详细方向估算旅行时间并优化多个点之间的路径

方向 API 接收起点和终点,并返回关于路线、旅行时间、距离和详细导航步骤的信息

除了每月的API调用次数,没有其他限制

获取方向端点返回详细的路线信息,包括地理编码的航点 估计的旅行距离 持续时间和逐步导航指令

响应中的关键字段包括“地理编码的路径点”用于位置信息“路线”用于路线信息“范围”用于地理限制和“版权”用于数据使用权

响应数据采用JSON格式结构,包含用于途经点和路线的嵌套对象。每条路线包含边界、步骤和旅行详情,便于解析和使用

用户可以指定参数,如“起点”和“终点”坐标,并可选择性地包括“交通方式”(例如,驾驶,步行)以定制他们的请求

该端点提供关于路线的信息,包括距离、持续时间、逐步 directions 和交通状况,这对于有效的旅行计划至关重要

数据准确性通过实时交通更新和可靠的地图来源得以保持,确保用户接收到最新和最有效的路线信息

典型的用例包括导航应用程序 旅行规划工具 配送服务以及任何需要路线优化和旅行时间估算的应用程序

用户可以从响应中提取特定的路线详情,例如旅行时间和距离,以在他们的应用中显示,或者使用逐步指示进行导航

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。

价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]


此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。

定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。

有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]

价格由月度或年度订阅决定,具体取决于所选计划。

API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。

Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。

要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。

要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。

要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。

"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。

是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。

您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。

7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。

当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。

付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。


相关 API


您可能还喜欢