این ابزار به شما کمک می‌کند تا بین یک مبدا و مقصد و یک یا چند نقطه بین آنها کوتاه‌ترین مسیر را پیدا کنید. همچنین شروطی را برای رسیدن به هر یک از این نقاط داشته باشید. به عنوان مثال شما شاید بخواهید حتما یک ایستگاه خاص قبل یا بعد از یک ایستگاه دیگر بازدید شود و یا آن ایستگاه خاص حتما بین ساعت 4 تا 6 بعدظهر بازدید شود چون به دلایلی در ساعاتی غیر از آن ساعات کسی برای تحویل گرفتن بسته شما وجود ندارد.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"5871005","collectionId":"43700fa7-9260-410a-8388-1c41a0a3fa36","publishedId":"RznHJcho","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2019-01-12T13:45:18.000Z"},"item":[{"name":"Plan a route","id":"bd04154c-ca00-4601-b03e-6f4611f4b293","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","type":"text","value":"Bearer {{access_token}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"webhook_url\": \"http://e438c29d.ngrok.io\",\n \"origin\": {\n \"geo\": {\n \"lat\": 35.734686,\n \"lng\": 51.370495\n }\n },\n \"destination\": {\n \"geo\": {\n \"lat\": 35.735601,\n \"lng\": 51.333876\n }\n },\n \"waypoints\": [\n {\n \"service_time\": 12,\n \"id\": \"stop-1\",\n \"restrictions\": {\n \"after\": \"stop-2\"\n },\n \"geo\": {\n \"lat\": 35.735601,\n \"lng\": 51.333876\n }\n },\n {\n \"id\": \"stop-2\",\n \"geo\": {\n \"lat\": 35.733198,\n \"lng\": 51.359832\n }\n },\n {\n \"id\": \"stop-3\",\n \"geo\": {\n \"lat\": 35.731386,\n \"lng\": 51.351174\n }\n }\n ]\n}"},"url":"https://planner.monhani.ir/api/v1/plan","description":"در بدنه درخواست، مختصات جغرافیایی یک مبدا، یک مقصد و توقفگاه‌های بین آنها را مشخص کنید. \nسیستم می‌تواند جواب درخواست شما را به دو صورت اعلام کند.
شیوه اول به این صورت است که در جواب درخواست، برای شما یک شناسه وظیفه برمی‌گردد که می‌توانید با رابط برنامه نویسی دیگری در هر زمان از وضعیت پردازش آن با خبر شوید، و روش دوم به این صورت است که با ست کردن آدرس یک وب هوک ما جواب را به محض آماده شدن برای شما ارسال کنیم.
Providing an origin, a destination and 1+ waypoints in request's body you'll get the results by either a) Calling \"Get route by job ID\" API or, b) have the route posted to you, on your provided Webhook URL whenever completed.
\nlocation can have a servicetime, expressed in minutes. This is the waiting or processing time at the location, the time delay between arrival and departure.\nNote: if no servicetime is given, the system default of 5 minutes is used.
\nEach waypoint in waypoints object described above is consisted of following key/values:
If nothing's wrong with your request, you'll get a response with 201 HTTP status showing your job is created and provides you with a job_id which you can later get the status of.
If something goes wrong with your request you may get one of these error messages:
\n","urlObject":{"protocol":"https","path":["api","v1","plan"],"host":["planner","monhani","ir"],"query":[],"variable":[]}},"response":[{"id":"2ae545b8-1b58-47e9-8b42-8884801ecf15","name":"Authentication Error","originalRequest":{"method":"POST","header":[{"key":"Authorization","type":"text","value":"{{access_token}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"webhook_url\": \"http://e438c29d.ngrok.io\",\n \"origin\": {\n \"geo\": {\n \"lat\": 35.734686,\n \"lng\": 51.370495\n }\n },\n \"destination\": {\n \"geo\": {\n \"lat\": 35.735601,\n \"lng\": 51.333876\n }\n },\n \"waypoints\": [\n {\n \"id\": \"stop-1\",\n \"restrictions\": {\n \"after\": \"stop-2\"\n },\n \"geo\": {\n \"lat\": 35.735601,\n \"lng\": 51.333876\n }\n },\n {\n \"id\": \"stop-2\",\n \"geo\": {\n \"lat\": 35.733198,\n \"lng\": 51.359832\n }\n },\n {\n \"id\": \"stop-3\",\n \"geo\": {\n \"lat\": 35.731386,\n \"lng\": 51.351174\n }\n }\n ]\n}"},"url":"https://planner.monhani.ir/api/v1/plan"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Sun, 03 Feb 2019 08:06:05 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"118"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"X-RateLimit-Limit","value":"1"},{"key":"X-RateLimit-Remaining","value":"0"},{"key":"X-RateLimit-Reset","value":"1549181167"},{"key":"ETag","value":"W/\"76-V8xAIpapD1C7Fqy+rpL42VXnwMY\""}],"cookie":[],"responseTime":null,"body":"{\n \"meta\": {\n \"status\": 401,\n \"message\": \"توکن معتبر نمی\\u200cباشد\",\n \"type\": \"AUTHENTICATION_ERROR\"\n },\n \"payload\": null\n}"},{"id":"80fe0d12-6fd1-48b8-8156-1ab70af65af8","name":"Plan a route","originalRequest":{"method":"POST","header":[{"key":"Authorization","type":"text","value":"{{access_token}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"webhook_url\": \"http://e438c29d.ngrok.io\",\n \"origin\": {\n \"geo\": {\n \"lat\": 35.734686,\n \"lng\": 51.370495\n }\n },\n \"destination\": {\n \"geo\": {\n \"lat\": 35.735601,\n \"lng\": 51.333876\n }\n },\n \"waypoints\": [\n {\n \"id\": \"stop-1\",\n \"restrictions\": {\n \"after\": \"stop-2\"\n },\n \"geo\": {\n \"lat\": 35.735601,\n \"lng\": 51.333876\n }\n },\n {\n \"id\": \"stop-2\",\n \"geo\": {\n \"lat\": 35.733198,\n \"lng\": 51.359832\n }\n },\n {\n \"id\": \"stop-3\",\n \"geo\": {\n \"lat\": 35.731386,\n \"lng\": 51.351174\n }\n }\n ]\n}"},"url":"https://planner.monhani.ir/api/v1/plan"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Sat, 02 Feb 2019 13:07:14 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"132"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"X-RateLimit-Limit","value":"1"},{"key":"X-RateLimit-Remaining","value":"0"},{"key":"X-RateLimit-Reset","value":"1549112835"},{"key":"ETag","value":"W/\"84-PUXrtyyG0+wxtkGDEVBXsyYIBdA\""}],"cookie":[],"responseTime":null,"body":"{\n \"meta\": {\n \"status\": 201,\n \"message\": \"درخواست با موفقیت ایجاد شد\"\n },\n \"payload\": {\n \"job_id\": \"5c559602d039aa0022f97816\"\n }\n}"},{"id":"cc31028d-8d4d-4efd-8739-4b1daa91e2dd","name":"Rate Limited","originalRequest":{"method":"POST","header":[{"key":"Authorization","type":"text","value":"{{access_token}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"webhook_url\": \"http://e438c29d.ngrok.io\",\n \"origin\": {\n \"geo\": {\n \"lat\": 35.734686,\n \"lng\": 51.370495\n }\n },\n \"destination\": {\n \"geo\": {\n \"lat\": 35.735601,\n \"lng\": 51.333876\n }\n },\n \"waypoints\": [\n {\n \"id\": \"stop-1\",\n \"restrictions\": {\n \"after\": \"stop-2\"\n },\n \"geo\": {\n \"lat\": 35.735601,\n \"lng\": 51.333876\n }\n },\n {\n \"id\": \"stop-2\",\n \"geo\": {\n \"lat\": 35.733198,\n \"lng\": 51.359832\n }\n },\n {\n \"id\": \"stop-3\",\n \"geo\": {\n \"lat\": 35.731386,\n \"lng\": 51.351174\n }\n }\n ]\n}"},"url":"https://planner.monhani.ir/api/v1/plan"},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Sun, 03 Feb 2019 08:05:47 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"153"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"X-RateLimit-Limit","value":"1"},{"key":"X-RateLimit-Remaining","value":"0"},{"key":"X-RateLimit-Reset","value":"1549181148"},{"key":"Retry-After","value":"1"},{"key":"ETag","value":"W/\"99-QG4iEeiEiseHoVWdmUWnB/ZpgVk\""}],"cookie":[],"responseTime":null,"body":"{\n \"meta\": {\n \"status\": 429,\n \"message\": \"تعداد درخواست\\u200cهای شما بیش از حد مجاز است\",\n \"type\": \"RATE_LIMITED_ERROR\"\n },\n \"payload\": null\n}"},{"id":"cc53a532-05cd-4e55-b8ff-f19bf4b9c903","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Authorization","type":"text","value":"{{access_token}}q"},{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"webhook_url\": \"http://e438c29d.ngrok.io\",\n \"origin\": {\n \"geo\": {\n \"lat\": 35.734686,\n \"lng\": 51.370495\n }\n },\n \"destination\": {\n \"geo\": {\n \"lat\": \"35.735601s\",\n \"lng\": 51.333876\n }\n },\n \"waypoints\": [\n {\n \"id\": \"stop-1\",\n \"restrictions\": {\n \"after\": \"stop-2\"\n },\n \"geo\": {\n \"lat\": 35.735601,\n \"lng\": 51.333876\n }\n },\n {\n \"id\": \"stop-2\",\n \"geo\": {\n \"lat\": 35.733198,\n \"lng\": 51.359832\n }\n },\n {\n \"id\": \"stop-3\",\n \"geo\": {\n \"lat\": 35.731386,\n \"lng\": 51.351174\n }\n }\n ]\n}"},"url":"https://planner.monhani.ir/api/v1/plan"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Sun, 03 Feb 2019 09:33:10 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"177"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"X-RateLimit-Limit","value":"1"},{"key":"X-RateLimit-Remaining","value":"0"},{"key":"X-RateLimit-Reset","value":"1549186392"},{"key":"ETag","value":"W/\"b1-M4NCzvydPDjEEHWCI7zc070E82Q\""}],"cookie":[],"responseTime":null,"body":"{\n \"meta\": {\n \"status\": 422,\n \"message\": null,\n \"type\": \"VALIDATION_ERROR\"\n },\n \"payload\": {\n \"validation_errors\": {\n \"destination.geo.lat\": \"عرض جغرافیایی معتبر نمی\\u200cباشد\"\n }\n }\n}"}],"_postman_id":"bd04154c-ca00-4601-b03e-6f4611f4b293"},{"name":"Get route details by job ID","id":"37c8d19a-86d2-4b4c-9352-6eecc6b9c411","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","type":"text","value":"Bearer {{access_token}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"url":"https://planner.monhani.ir/api/v1/plan/{{job_id}}","description":"با داشتن شناسه وظیفه که از رابط برنامه نویسی بالا بدست آورده‌اید، می‌توانید از وضعیت پردازش یا جواب آن در هر لحظه باخبر شوید.
\nHaving your job_id returned from \"Plan a route\" API, you can get the actual route or the processing status.
You may get a response with 200 HTTP status if everything goes perfectly or one of these error types if there was something wrong with your request.