[{"data":1,"prerenderedAt":947},["ShallowReactive",2],{"navigation_docs":3,"-services-composables":67,"-services-composables-surround":944},[4,23,53],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":22},"快速上手","i-lucide-rocket","\u002Fgetting-started","01.getting-started",[10,14,18],{"title":11,"path":12,"stem":13},"安装","\u002Fgetting-started\u002Finstallation","01.getting-started\u002F01.installation",{"title":15,"path":16,"stem":17},"密钥（tk）","\u002Fgetting-started\u002Fapikey","01.getting-started\u002F02.apikey",{"title":19,"path":20,"stem":21},"第一个地图","\u002Fgetting-started\u002Ffirst-map","01.getting-started\u002F03.first-map",false,{"title":24,"icon":25,"path":26,"stem":27,"children":28,"page":22},"组件","i-lucide-component","\u002Fcomponents","02.components",[29,33,37,41,45,49],{"title":30,"path":31,"stem":32},"地图","\u002Fcomponents\u002Fmap","02.components\u002F01.map",{"title":34,"path":35,"stem":36},"覆盖物","\u002Fcomponents\u002Foverlays","02.components\u002F02.overlays",{"title":38,"path":39,"stem":40},"控件","\u002Fcomponents\u002Fcontrols","02.components\u002F03.controls",{"title":42,"path":43,"stem":44},"工具","\u002Fcomponents\u002Ftools","02.components\u002F04.tools",{"title":46,"path":47,"stem":48},"图层","\u002Fcomponents\u002Flayers","02.components\u002F05.layers",{"title":50,"path":51,"stem":52},"标绘","\u002Fcomponents\u002Fplot-symbols","02.components\u002F06.plot-symbols",{"title":54,"icon":55,"path":56,"stem":57,"children":58,"page":22},"服务","i-lucide-plug","\u002Fservices","03.services",[59,63],{"title":60,"path":61,"stem":62},"REST 服务","\u002Fservices\u002Frest","03.services\u002F01.rest",{"title":64,"path":65,"stem":66},"SDK 服务","\u002Fservices\u002Fcomposables","03.services\u002F02.composables",{"id":68,"title":64,"body":69,"description":938,"extension":939,"links":940,"meta":941,"navigation":155,"path":65,"seo":942,"stem":66,"__hash__":943},"docs\u002F03.services\u002F02.composables.md",{"type":70,"value":71,"toc":927},"minimark",[72,84,89,296,408,412,475,486,490,550,570,574,626,640,644,651,655,723,744,748,816,842,846,895,898,923],[73,74,75,79,80,83],"p",{},[76,77,78],"code",{},"@tianditu\u002Fvue"," 将官方文档 service\u002F 目录下的服务类封装为组合式函数。它们要在 ",[76,81,82],{},"\u003CTdtMap>"," 内部的 setup 里调用（SDK 就绪后才会创建实例），回调统一改为 Promise。",[85,86,88],"h2",{"id":87},"地名搜索-uselocalsearch","地名搜索 useLocalSearch",[90,91,96],"pre",{"className":92,"code":93,"language":94,"meta":95,"style":95},"language-vue shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u003Cscript setup>\nimport { useLocalSearch } from \"@tianditu\u002Fvue\";\n\nconst { search } = useLocalSearch({ pageCapacity: 10 });\n\nconst doSearch = async (keyword) => {\n  const result = await search(keyword);\n  console.log(result);\n};\n\u003C\u002Fscript>\n","vue","",[76,97,98,118,150,157,200,205,234,259,280,286],{"__ignoreMap":95},[99,100,103,107,111,115],"span",{"class":101,"line":102},"line",1,[99,104,106],{"class":105},"sMK4o","\u003C",[99,108,110],{"class":109},"swJcz","script",[99,112,114],{"class":113},"spNyl"," setup",[99,116,117],{"class":105},">\n",[99,119,121,125,128,132,135,138,141,144,147],{"class":101,"line":120},2,[99,122,124],{"class":123},"s7zQu","import",[99,126,127],{"class":105}," {",[99,129,131],{"class":130},"sTEyZ"," useLocalSearch",[99,133,134],{"class":105}," }",[99,136,137],{"class":123}," from",[99,139,140],{"class":105}," \"",[99,142,78],{"class":143},"sfazB",[99,145,146],{"class":105},"\"",[99,148,149],{"class":105},";\n",[99,151,153],{"class":101,"line":152},3,[99,154,156],{"emptyLinePlaceholder":155},true,"\n",[99,158,160,163,165,168,171,174,177,180,183,186,189,193,195,198],{"class":101,"line":159},4,[99,161,162],{"class":113},"const",[99,164,127],{"class":105},[99,166,167],{"class":130}," search ",[99,169,170],{"class":105},"}",[99,172,173],{"class":105}," =",[99,175,131],{"class":176},"s2Zo4",[99,178,179],{"class":130},"(",[99,181,182],{"class":105},"{",[99,184,185],{"class":109}," pageCapacity",[99,187,188],{"class":105},":",[99,190,192],{"class":191},"sbssI"," 10",[99,194,134],{"class":105},[99,196,197],{"class":130},")",[99,199,149],{"class":105},[99,201,203],{"class":101,"line":202},5,[99,204,156],{"emptyLinePlaceholder":155},[99,206,208,210,213,216,219,222,226,228,231],{"class":101,"line":207},6,[99,209,162],{"class":113},[99,211,212],{"class":130}," doSearch ",[99,214,215],{"class":105},"=",[99,217,218],{"class":113}," async",[99,220,221],{"class":105}," (",[99,223,225],{"class":224},"sHdIc","keyword",[99,227,197],{"class":105},[99,229,230],{"class":113}," =>",[99,232,233],{"class":105}," {\n",[99,235,237,240,243,245,248,251,253,255,257],{"class":101,"line":236},7,[99,238,239],{"class":113},"  const",[99,241,242],{"class":130}," result",[99,244,173],{"class":105},[99,246,247],{"class":123}," await",[99,249,250],{"class":176}," search",[99,252,179],{"class":109},[99,254,225],{"class":130},[99,256,197],{"class":109},[99,258,149],{"class":105},[99,260,262,265,268,271,273,276,278],{"class":101,"line":261},8,[99,263,264],{"class":130},"  console",[99,266,267],{"class":105},".",[99,269,270],{"class":176},"log",[99,272,179],{"class":109},[99,274,275],{"class":130},"result",[99,277,197],{"class":109},[99,279,149],{"class":105},[99,281,283],{"class":101,"line":282},9,[99,284,285],{"class":105},"};\n",[99,287,289,292,294],{"class":101,"line":288},10,[99,290,291],{"class":105},"\u003C\u002F",[99,293,110],{"class":109},[99,295,117],{"class":105},[297,298,299,312],"table",{},[300,301,302],"thead",{},[303,304,305,309],"tr",{},[306,307,308],"th",{},"返回",[306,310,311],{},"说明",[313,314,315,329,354,368,378,388,398],"tbody",{},[303,316,317,323],{},[318,319,320],"td",{},[76,321,322],{},"searcher",[318,324,325,328],{},[76,326,327],{},"LocalSearch"," 实例的响应式引用",[303,330,331,340],{},[318,332,333,336,337],{},[76,334,335],{},"results"," \u002F ",[76,338,339],{},"status",[318,341,342,343,346,347,346,350,353],{},"搜索结果与状态（",[76,344,345],{},"idle","\u002F",[76,348,349],{},"loading",[76,351,352],{},"done","）",[303,355,356,361],{},[318,357,358],{},[76,359,360],{},"search(keyword, type?)",[318,362,363,364,367],{},"关键词检索，",[76,365,366],{},"type"," 为官方检索类型，不传时为普通搜索",[303,369,370,375],{},[318,371,372],{},[76,373,374],{},"searchInBounds(keyword, bounds)",[318,376,377],{},"范围搜索",[303,379,380,385],{},[318,381,382],{},[76,383,384],{},"searchNearby(keyword, center, radius)",[318,386,387],{},"周边搜索",[303,389,390,395],{},[318,391,392],{},[76,393,394],{},"gotoPage(page)",[318,396,397],{},"结果分页",[303,399,400,405],{},[318,401,402],{},[76,403,404],{},"clearResults()",[318,406,407],{},"清空结果",[85,409,411],{"id":410},"反地址解析-usegeocoder","反地址解析 useGeocoder",[90,413,417],{"className":414,"code":415,"language":416,"meta":95,"style":95},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","const { getLocation } = useGeocoder();\n\nconst result = await getLocation([116.404, 39.915]);\n","typescript",[76,418,419,440,444],{"__ignoreMap":95},[99,420,421,423,425,428,430,432,435,438],{"class":101,"line":102},[99,422,162],{"class":113},[99,424,127],{"class":105},[99,426,427],{"class":130}," getLocation ",[99,429,170],{"class":105},[99,431,173],{"class":105},[99,433,434],{"class":176}," useGeocoder",[99,436,437],{"class":130},"()",[99,439,149],{"class":105},[99,441,442],{"class":101,"line":120},[99,443,156],{"emptyLinePlaceholder":155},[99,445,446,448,451,453,455,458,461,464,467,470,473],{"class":101,"line":152},[99,447,162],{"class":113},[99,449,450],{"class":130}," result ",[99,452,215],{"class":105},[99,454,247],{"class":123},[99,456,457],{"class":176}," getLocation",[99,459,460],{"class":130},"([",[99,462,463],{"class":191},"116.404",[99,465,466],{"class":105},",",[99,468,469],{"class":191}," 39.915",[99,471,472],{"class":130},"])",[99,474,149],{"class":105},[73,476,477,478,481,482,485],{},"解析成功返回 ",[76,479,480],{},"GeocoderResult","，失败返回 ",[76,483,484],{},"null","。",[85,487,489],{"id":488},"浏览器定位-usegeolocation","浏览器定位 useGeolocation",[90,491,493],{"className":414,"code":492,"language":416,"meta":95,"style":95},"const { getCurrentPosition } = useGeolocation();\n\nconst result = await getCurrentPosition({ timeout: 5000 });\n",[76,494,495,515,519],{"__ignoreMap":95},[99,496,497,499,501,504,506,508,511,513],{"class":101,"line":102},[99,498,162],{"class":113},[99,500,127],{"class":105},[99,502,503],{"class":130}," getCurrentPosition ",[99,505,170],{"class":105},[99,507,173],{"class":105},[99,509,510],{"class":176}," useGeolocation",[99,512,437],{"class":130},[99,514,149],{"class":105},[99,516,517],{"class":101,"line":120},[99,518,156],{"emptyLinePlaceholder":155},[99,520,521,523,525,527,529,532,534,536,539,541,544,546,548],{"class":101,"line":152},[99,522,162],{"class":113},[99,524,450],{"class":130},[99,526,215],{"class":105},[99,528,247],{"class":123},[99,530,531],{"class":176}," getCurrentPosition",[99,533,179],{"class":130},[99,535,182],{"class":105},[99,537,538],{"class":109}," timeout",[99,540,188],{"class":105},[99,542,543],{"class":191}," 5000",[99,545,134],{"class":105},[99,547,197],{"class":130},[99,549,149],{"class":105},[73,551,552,553,555,556,559,560,346,563,346,566,569],{},"定位失败返回 ",[76,554,484],{},"；配置项为官方 ",[76,557,558],{},"GeolocationOptions","（",[76,561,562],{},"enableHighAccuracy",[76,564,565],{},"maximumAge",[76,567,568],{},"timeout","）。",[85,571,573],{"id":572},"驾车规划-usedrivingroute-公交规划-usetransitroute","驾车规划 useDrivingRoute \u002F 公交规划 useTransitRoute",[90,575,577],{"className":414,"code":576,"language":416,"meta":95,"style":95},"const { search } = useDrivingRoute(T.DrivingRoutePolicy.LEAST_TIME);\nawait search(startLngLat, endLngLat);\n",[76,578,579,609],{"__ignoreMap":95},[99,580,581,583,585,587,589,591,594,597,599,602,604,607],{"class":101,"line":102},[99,582,162],{"class":113},[99,584,127],{"class":105},[99,586,167],{"class":130},[99,588,170],{"class":105},[99,590,173],{"class":105},[99,592,593],{"class":176}," useDrivingRoute",[99,595,596],{"class":130},"(T",[99,598,267],{"class":105},[99,600,601],{"class":130},"DrivingRoutePolicy",[99,603,267],{"class":105},[99,605,606],{"class":130},"LEAST_TIME)",[99,608,149],{"class":105},[99,610,611,614,616,619,621,624],{"class":101,"line":120},[99,612,613],{"class":123},"await",[99,615,250],{"class":176},[99,617,618],{"class":130},"(startLngLat",[99,620,466],{"class":105},[99,622,623],{"class":130}," endLngLat)",[99,625,149],{"class":105},[73,627,628,629,559,632,635,636,639],{},"构造时传入策略，返回 ",[76,630,631],{},"{ router, results, search }",[76,633,634],{},"search(start, end)","，公交规划 ",[76,637,638],{},"useTransitRoute(policy)"," 同构）。",[85,641,643],{"id":642},"公交线路查询-usebuslinesearch","公交线路查询 useBusLineSearch",[73,645,646,647,650],{},"返回 ",[76,648,649],{},"{ searcher, busList, busLine, getBusList, getBusLine }","——先按线路名取线路列表，再取具体线路详情。",[85,652,654],{"id":653},"数据来源-usedatasources","数据来源 useDataSources",[90,656,658],{"className":414,"code":657,"language":416,"meta":95,"style":95},"const { search } = useDataSources();\nconst result = await search({ level: 12, bound: \"…\" });\n",[76,659,660,679],{"__ignoreMap":95},[99,661,662,664,666,668,670,672,675,677],{"class":101,"line":102},[99,663,162],{"class":113},[99,665,127],{"class":105},[99,667,167],{"class":130},[99,669,170],{"class":105},[99,671,173],{"class":105},[99,673,674],{"class":176}," useDataSources",[99,676,437],{"class":130},[99,678,149],{"class":105},[99,680,681,683,685,687,689,691,693,695,698,700,703,705,708,710,712,715,717,719,721],{"class":101,"line":120},[99,682,162],{"class":113},[99,684,450],{"class":130},[99,686,215],{"class":105},[99,688,247],{"class":123},[99,690,250],{"class":176},[99,692,179],{"class":130},[99,694,182],{"class":105},[99,696,697],{"class":109}," level",[99,699,188],{"class":105},[99,701,702],{"class":191}," 12",[99,704,466],{"class":105},[99,706,707],{"class":109}," bound",[99,709,188],{"class":105},[99,711,140],{"class":105},[99,713,714],{"class":143},"…",[99,716,146],{"class":105},[99,718,134],{"class":105},[99,720,197],{"class":130},[99,722,149],{"class":105},[73,724,725,726,555,729,559,732,346,735,346,738,346,741,569],{},"查询当前地图数据的来源，结果为 ",[76,727,728],{},"{ ds: \"数据来源\" }",[76,730,731],{},"DataSourcesOptions",[76,733,734],{},"level",[76,736,737],{},"bound",[76,739,740],{},"layers",[76,742,743],{},"projection",[85,745,747],{"id":746},"行政区查询-useadministrativedivision","行政区查询 useAdministrativeDivision",[90,749,751],{"className":414,"code":750,"language":416,"meta":95,"style":95},"const { search } = useAdministrativeDivision();\nconst result = await search({ searchWord: \"北京\", searchType: 1 });\n",[76,752,753,772],{"__ignoreMap":95},[99,754,755,757,759,761,763,765,768,770],{"class":101,"line":102},[99,756,162],{"class":113},[99,758,127],{"class":105},[99,760,167],{"class":130},[99,762,170],{"class":105},[99,764,173],{"class":105},[99,766,767],{"class":176}," useAdministrativeDivision",[99,769,437],{"class":130},[99,771,149],{"class":105},[99,773,774,776,778,780,782,784,786,788,791,793,795,798,800,802,805,807,810,812,814],{"class":101,"line":120},[99,775,162],{"class":113},[99,777,450],{"class":130},[99,779,215],{"class":105},[99,781,247],{"class":123},[99,783,250],{"class":176},[99,785,179],{"class":130},[99,787,182],{"class":105},[99,789,790],{"class":109}," searchWord",[99,792,188],{"class":105},[99,794,140],{"class":105},[99,796,797],{"class":143},"北京",[99,799,146],{"class":105},[99,801,466],{"class":105},[99,803,804],{"class":109}," searchType",[99,806,188],{"class":105},[99,808,809],{"class":191}," 1",[99,811,134],{"class":105},[99,813,197],{"class":130},[99,815,149],{"class":105},[73,817,818,821,822,559,825,346,828,346,831,346,834,837,838,841],{},[76,819,820],{},"searchType","：0 根据 code 查询、1 根据名称查询；其余配置项见官方 ",[76,823,824],{},"AdministrativeDivisionOptions",[76,826,827],{},"needSubInfo",[76,829,830],{},"needAll",[76,832,833],{},"needPolygon",[76,835,836],{},"needPre","）。结果经 ",[76,839,840],{},"getStatus()"," 判断：100 正常、101 没有查到结果。",[85,843,845],{"id":844},"城市信息-uselocalcity","城市信息 useLocalCity",[90,847,849],{"className":414,"code":848,"language":416,"meta":95,"style":95},"const { location } = useLocalCity();\nconst info = await location();\n\u002F\u002F info.lnglat 城市中心点、info.level 最佳级别、info.cityName 城市名称\n",[76,850,851,871,889],{"__ignoreMap":95},[99,852,853,855,857,860,862,864,867,869],{"class":101,"line":102},[99,854,162],{"class":113},[99,856,127],{"class":105},[99,858,859],{"class":130}," location ",[99,861,170],{"class":105},[99,863,173],{"class":105},[99,865,866],{"class":176}," useLocalCity",[99,868,437],{"class":130},[99,870,149],{"class":105},[99,872,873,875,878,880,882,885,887],{"class":101,"line":120},[99,874,162],{"class":113},[99,876,877],{"class":130}," info ",[99,879,215],{"class":105},[99,881,247],{"class":123},[99,883,884],{"class":176}," location",[99,886,437],{"class":130},[99,888,149],{"class":105},[99,890,891],{"class":101,"line":152},[99,892,894],{"class":893},"sHwdD","\u002F\u002F info.lnglat 城市中心点、info.level 最佳级别、info.cityName 城市名称\n",[85,896,897],{"id":897},"通用说明",[899,900,901,912],"ul",{},[902,903,904,905,908,909,911],"li",{},"全部 composable 同时 expose 了官方实例（如 ",[76,906,907],{},"geocoder","、",[76,910,322],{},"），可命令式调用实例上的其余官方方法",[902,913,914,915,918,919],{},"这些封装的是 ",[76,916,917],{},"window.T"," 上的 SDK 服务类；纯 HTTP REST 场景请用 ",[920,921,922],"a",{"href":61},"@tianditu\u002Fservices",[924,925,926],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}",{"title":95,"searchDepth":120,"depth":120,"links":928},[929,930,931,932,933,934,935,936,937],{"id":87,"depth":120,"text":88},{"id":410,"depth":120,"text":411},{"id":488,"depth":120,"text":489},{"id":572,"depth":120,"text":573},{"id":642,"depth":120,"text":643},{"id":653,"depth":120,"text":654},{"id":746,"depth":120,"text":747},{"id":844,"depth":120,"text":845},{"id":897,"depth":120,"text":897},"Vue 组合式函数封装的官方 service 类","md",null,{},{"title":64,"description":938},"BxiYhAAJGoaRGq6qQMfsqjd0Hz02uwm_iMVuJChcLGk",[945,940],{"title":60,"path":61,"stem":62,"description":946,"children":-1},"@tianditu\u002Fservices 类型化服务客户端",1788755011119]