Turn-by-turn navigation instructions

Product Used: Navigation API


NextBillion.ai’s Navigation API returns step-by-step instructions in the desired language to facilitate a seamless navigation experience for your drivers. The Navigation API can be easily customized using a wide range of routing constraints available with the service and depending on the type of request, the routing engine will suggest optimal routes as per the given constraints and traffic conditions.

In this example, we are going to request step-by-step instructions for a trip with a couple of stopovers before the destination by configuring

  • A pair of “origin” & “destination” locations
  • “mode” option set to “truck”.
  • “waypoints” parameter containing coordinates for 3 stops before the “destination”
  • “lang” set to “es” for instructions in Spanish

Request

1curl --location 'https://api.nextbillion.io/navigation/json?key=<your_api_key>&origin=25.84220637,-80.36236245&destination=25.76683324,-80.21609475&mode=truck&waypoints=25.91338203,-80.34023395|25.90554444,-80.25598479|25.84769524,-80.22941337&lang=es'

Response

Observe that all the stops are covered by the route on the way to destination.

1{
2 "status": "Ok",
3 "routes": [
4 {
5 "geometry": "y`hhp@zw|gxChNYzDIfAC~|@{@vDEnECG}i@Imm@Iys@@s^FiUCcSAkOzAkjBJqWHa[DiJJouACmEEyIK{VOo|AEag@m@a}GAuICoTAwQp@uxFAmPQ{hBW_oAGu`@?sK?qEBwJ@kG@_D@cFl@ga@Ie[d@geA@qj@y@kh@k@q_@IwC_B{i@I_CEcIE_IY{f@d@}aAAih@@{HMaNB}WBiODgH?}BByLUa_@@qIDkWKqUEoJAuBCqJZsOBiKGse@BcMGaQ?qHL{GAeDAuEv@yShAcXX}ON}GGqLU_NDod@?qE?wJ?kF?{G?ol@}DHoEN}IF{EH_Hn@gBb@wXpKgR|GqCbAeHlBuL~BeLhBiJ`AmLp@{Il@qCXwGxA{G`BeFt@aJHsSRqVTml@j@st@r@yBB{Y^wb@f@uKLs[^s`@h@c\\b@gEF_sAhAuzAbAmXZiJJaMNuTVyIHsHL{ABwIFkGFmA@iA@_HFoC@kFDa]VwS?wa@?{WNsYVcn@^iKFql@XeL?aWJu^NqBBc]b@}W\\yEFaDBqVX_PNqbBjCgd@t@oMD{v@h@kc@\\ot@~Am}@lAoHBoKLwm@h@y|AjAuW\\cHJkd@p@yINcKNmPZsg@|@wHNaEHqEH{HNg]n@sVDiA@mVd@_GJgKLcu@~@{c@n@eeAvAgi@XwDF_[b@s\\p@wGLwTb@oVX{Uj@ixApCe[~@y|C~GwEByHTmDPgIJgK@iGN{JFgt@X}x@z@cb@n@ob@fAit@lBc^`Ayf@~@gXTwPLq\\`@sFJ}HRgIN}KVoGNsEJmCHalAnBsEHiDFgHJsQXiIPyMTuADe^`AyUx@aIJcLNmk@z@k|A~BgQXyBDoBD_CDmDH}BDsFJiDF_FJ{IP{FHgPXk[h@uGJ{V\\oBBkBDuBBeFDeMT_KLcMb@{IXiDJ_Hc@mUwAkVU_FEiHEkVEof@h@s`@j@k^t@a[p@uQh@{GNkVZg]\\{PNqaBtCk|@`ByLTco@bAgSf@mMeA{m@]mHEy@AmUD{gA|@eQJoEDaE@F`MK~DB~IDrI@rD@jM?dENhUBrM?hCLrR@|E?|G?bAAxK?jD@bGBbK@xG@~G@jJBb\\?bL@`L?dL@xQ?bP?tU?vU?r]?bM?r]Afm@?vG?f`@AhUExgBFfSFnRj@bfAG`sCDvd@Nd[@pAC`i@@jGBjZ@xC@xE?jDd@`gBHjZLlVUbQKdHa@jFe@jC_Ab@i@h@g@rA?pCn@dBzAfAhBRz@Gv@[p@m@j@cAXaBAkAGm@Km@M}AAq@IwReAsmDA_OCuYEeGAwWz@ohFYelAUw`@?mnA?iQ?o\\Dc_@b@uR[_c@F_l@?oDBaXBkVBef@?_C?oBB{UCgF?uF@kW?gQ?gLAgEAiLAuN?cF@wFAyLbLv@jKTzIR`KKtFUrMgB~EyAbEqBfFyCxDeClCuBhEsDhDyChU}SlRmQjIgHnFaEzDyClFsC~E}BrGoBhG{AtIoA`Fg@xUi@`QqCn`BqDrk@eAhUk@nKSdBA`GCtDIrKUhNUbKIpOk@n[c@~pAqBn`@YhrA{CtGlAhFZfCBpC?zFKzGEtLFfJAbw@`Arg@d@nGN~SNx@@hKNdBBhFX`Fl@hEbAzC~@pCpArGrEpBlBjCpCxC`FnB|DbBnGv@rGJnF?xEMlDk@tFi@xDo@bD_AxC{AvDmA`CwAlCaBjCuBfCeBdBiB`BuEvDsBzAwC`BmClAyCjAsDhA_E`AoDh@_F^gHZoECcBIsBEcF]cE]qDi@qA_@mGsBqFyBcDaBcGuDuF{EgGsGaAkA{@kAiEmGmAeCqA{C_AcCoAcE{@yCu@sCaKeb@s@aPYgJQaLGaFAaE?iAHiDJ{EBeBZcH^qIhA}Q~@oKt@gJrAwJjDaR`DmNpDqRjCcNTmAnAsFr@{C~BkLbIub@nDeQxCkPlC{N~D_TbCoNlBqL~AoKbByKhBkP`BcVTuDPyCByAToKXaM?ga@@{h@Iq`CSgp@OgVs@wp@wBg~AWe^EcOj@g`@n@qQ`A{TbCk_@jCkVt@iGrEa_@nAaK`G}d@|P_rAdGwd@tFsc@VsBbDgYpAaK~BySl[ilCbBwNdB_PfA}HbBoOpD}[rEkc@~B}W\\_E`BeSvAcQt@qLrDuh@RkFtAuY`@{KpAg\\v@iU^iS\\sR\\{UhAaxAVo]GyKCyHWsd@wAa`A_A}r@KgHWiRyAccAGqDGcQWaLQ_Lu@gf@YqQSmNQqMCqEGgJEaJFoJJiGVaGTcGd@oHn@cI`A{IdA}HfBaMrA{HlBuJrCeM`EuNbCcIxBsGrCmHdCeGjBkEnByD|C}FrDqG|CkFzDiGpC_EnBoCt@eA`FmGrGyH`L}LvWyXxRqTjG}Gzl@_p@nBwBtt@ax@na@wc@`M}MjYa[ba@mc@tRsSdSaUxL{NjDiEvJ_KbFgFrG_IfF_HlDwDxCqEvGwH~@gB|KyOpUg]zDeGbMyRpEsH`G{JbDcGxGkM`FkJvHoOtLsVfWkl@|Km[~AaFfD{J~Mac@nBgH`EsNdEsMdBwGr@qCjEkPhEsQfCkKvHsY~@cEv@{Cp@iDd@{BVoA~DeR|AqH`BuHxJgg@|Qc`A`Nwr@rGm]jAiFtDwQ|HcTfAuE|AaFrBcEdCuDhCaDxCcCzCkB`DkAbDm@fDUhDBhD\\bDv@zClAnCdB`CvBvBfCfBvCrAbD`AnDf@xDPzDEzD[~Ds@~DeAnD}AbDoBtCaCbCkClByCzAiDbAwDl@oEZcF?sFYsB_@aVyAoGeAuGgA}HeAaLcA}Hg@}CKaNUqGEqQGuf@^m}@dAaZAq[[m[u@qGQkBIoHe@cLo@sEYuEYsCSsCU_Ge@mAKyGk@sCW{JaAyGy@wLyAoMcBiKyAcMoBaGgA{JiBgL{BmJsBiMqCsBg@}Bk@gJ{BuPqEaJoCaI_CuCy@oDoAwHiCiS_HiG}Ba@OuTeIyeCejAy_@eQq@_@sS}JkQaIsJkEcAc@yBcA}BeAeJiE_M}Fo]cPoMeG}QsHkNaFqO}EwOgEsKeCmCm@cP}C}TiDG{C@{CN_IoHOcGEa@?m_Bj@cXC{QUuGUiKk@oIo@zFq|@uNqAiU_E_LoBqNiEoQqFkNaGgNaHmRkKkBuAjBtAtc@sp@`d@ko@hRyZ`LqQ~DkIsFqCuC_BmEqCcFqDeCyBmHkGgD{DgC{CiA_B{CkEaEiHqDqHqAcDgCmGiD}KqBgKaAsG{@wHo@aH[_IUwNoAa}@_@i^eA_}@KkIYwT{@io@}A{kAeAc~@o@oj@OiMzDGbQWzT]fPWvXYfGGjGExPS`HOlNSbY]`JWjRStFIpEGlKKzMMvT_@bGIlDGjBCpFIhPKxKQfe@u@dNQ`JM|HKpMQdGK~IOtIOfGAnJKbDErCExBCjHM`U[~x@kAvBC|`@i@dQUrBCpT[~PUdMQjNQbQUfTYfi@q@`]e@lDEhHIxFI|PUfBChIKjhAwAfUYnBEjEGxb@i@rp@{@~BCvCEfHKxGI`b@i@zSYdIKt[c@rOSbf@q@`QWpOIxJEnBAdHEbCArLFvTEzOO~EG`HKfCEzNWfIQjNQ~CEzCDViIpAc`@XaNTsLJ{G?oDAcNBg`@Eqi@EuOCyl@@iM@gFE_D?eDGk_AIor@GkEBkHAgHAiLCmSAsVAmL?kB?{BAw\\jJKnGItEEjRS~Z[tTWhSWhv@q@rH@td@Yng@w@zoAoAv_@a@nBEtZs@hc@gAxKm@fLgApE]bEc@nM{A`SwBxLkAbE[jF_@tG[bKe@nMWvKQp]]n`@_@|NP|U\\rEFhB@nABpBTn@DbBJvNjAvDX~SfB`CJpHb@xMl@lEJnB@hFD|F?n`@MjDKdLKvHG`CAdSQbHIbUYlTWjHGn[YzGGjECzJIt\\k@tXMrPGvNYb[w@f]UdOKzX_@tQUrXUbSUxe@c@nEIbPYnIOtPYpDEzGEb`@QpJG`a@[vCIlWWxNO~EEvd@o@xIGzc@g@zd@i@zQUdg@c@vNMjx@cAvTUvMMpSSje@s@|EGn^e@le@g@l[c@rHKxRU|NS~BC|NQlSUjOQxNOvFS|d@c@xKOhY_@EcDG}CYqVqBubBaB_lASgOGcGWyYhFIz[e@nV]|I@xQInU_@jCIvCGg@yh@SqTi@gg@YcWKsKOgN[a^WeSw@yo@AmCWo]I{KKiOg@oc@IgIUiN_@_e@EcEYmWQkPEgFg@ca@_Aa~@[_VSkJOsCWqBmAkB?cEKaMKmFs@s`@MwNAcCYi^k@o^k@s`@GcLKgLU_UYcWW{Ra@c\\G}GCaBEmEMyKQsPUmQGkEYsUs@so@QgP[c_@[o^cAqaACmBGqFC}AIuIE}LEeOMuHo@m_@GmFGgDOoMvIQvFCtQqAdIo@nIkA~IkBlJmC`KsDjLeFrPsIzVyLjFoC~EoDrk@iTrNqElEqA~KwCjLuBpJ{AtDk@zLyAhL}@jKo@tQe@pT_@bd@w@nf@U|FChUGjU]xFBtG?jNGlh@CzTV|h@IvKCtKGrNGxT[lJGvPWbQk@xDSjPOnq@iAh{@oAlu@iAjBBnBKdDGv][hUWhLRdZn@~]zAfI`AnHn@lGz@pWnElUpFdPfCvEv@dUdDxInAfR`CrMvAvQnAnQr@bOZza@Fdt@_A`STbAC`^u@tVe@js@s@rJKhPS|Uc@fWQx[o@fSW`TSh]e@bcAsBn[g@f]QdL_@re@{@hECx^kB~CO~i@uC~NSj\\[dMWhTWxKY|b@kApOSpT[dh@WvMa@~ACbE?dQc@j^c@piAeA`w@eA`E?zPWrMStp@g@z_@[jQQlSWnd@kAhIOn_@Kpf@[bUQhHQ|\\a@xLgAfN]lGIfUY~JW~P_@xYiAj_@q@tVs@bN_@jMYvc@mAvp@gBf_@SpUYhc@Ofw@KhIA|PMz^Yvv@m@bSQ|MK`y@eAxLQnW_@df@y@zAA~GKdFQ~CMt@EvAIzAGdBM`BIjAKhBMtAMpCWpD_@dD_@fAQtCa@jSyCrUqD|YyGlI{BdM{DrNoFf@Mn_@gRpBcA|@W`HwBlDqApH{ClIuD~MgGnOeHlD_BxBu@fGiCjGcCnKeExq@aWpr@yZdM_GbKyE|O}H~H_ExH_ElNiIbOqH`j@mZ|PeIzGaD`_@kOtg@cS|FoB|IqC|JcCbLsBfb@{G~O_BhS{AtNg@xEGvz@y@n{@u@p{@qA`MOlb@_@pIbAdGZjHN|MFrMNhGKpE?hDOpDOtE]hMuAfCe@nTaFhr@uTvHqAfE_AbLqBnScBlJCzFC`DHpSfB|HdBhF|A|G`CpGvBdShGzQpGrIlC|KtD|@VfN~DlMhDxHfBxGfAnIrAhOnCzk@jKjMhBrm@dMTlWL`NBbD^z`@Xd[|BzfBV~[HbLDxDPpUZba@^fUD`C`@vXVn`@JrQ`@v_@FvFNbNp@~n@dBrcC`@~^bAz}@dAl~@JfIHrHXnUL|NRxTJfLFzFD|EFpHNpPJhKeHD",
6 "distance": 50570.4,
7 "duration": 3579.3,
8 "start_location": {
9 "latitude": 25.842205,
10 "longitude": -80.362382
11 },
12 "end_location": {
13 "latitude": 25.766832,
14 "longitude": -80.216157
15 },
16 "legs": [
17 {
18 "distance": {

Visit Navigation API documentation to know more about the available features.

Have Questions ?