[{"data":1,"prerenderedAt":790},["ShallowReactive",2],{"navigation":3,"\u002Ffeatures\u002Fkmz-import":61,"\u002Ffeatures\u002Fkmz-import-surround":785},[4,23,46],{"title":5,"path":6,"stem":7,"children":8,"icon":22},"Getting Started","\u002Fgetting-started","1.getting-started\u002F1.index",[9,12,17],{"title":10,"path":6,"stem":7,"icon":11},"Introduction","i-lucide-house",{"title":13,"path":14,"stem":15,"icon":16},"Quick Start","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation","i-lucide-rocket",{"title":18,"path":19,"stem":20,"icon":21},"Dashboard","\u002Fgetting-started\u002Fusage","1.getting-started\u002F3.usage","i-lucide-layout-dashboard",false,{"title":24,"icon":22,"path":25,"stem":26,"children":27,"page":22},"Features","\u002Ffeatures","2.features",[28,32,37,42],{"title":18,"path":29,"stem":30,"icon":31},"\u002Ffeatures\u002Fdashboard","2.features\u002F1.dashboard","i-lucide-gauge",{"title":33,"path":34,"stem":35,"icon":36},"Flow Bands","\u002Ffeatures\u002Fflow-bands","2.features\u002F2.flow-bands","i-lucide-activity",{"title":38,"path":39,"stem":40,"icon":41},"Reach Pages","\u002Ffeatures\u002Freach-pages","2.features\u002F3.reach-pages","i-lucide-map-pin",{"title":43,"path":44,"stem":45},"KMZ Import Guide","\u002Ffeatures\u002Fkmz-import","2.features\u002F4.kmz-import",{"title":47,"icon":22,"path":48,"stem":49,"children":50,"page":22},"Developer","\u002Fdeveloper","3.developer",[51,56],{"title":52,"path":53,"stem":54,"icon":55},"Architecture","\u002Fdeveloper\u002Farchitecture","3.developer\u002F1.architecture","i-lucide-layers",{"title":57,"path":58,"stem":59,"icon":60},"Public API","\u002Fdeveloper\u002Fapi","3.developer\u002F2.api","i-lucide-code",{"id":62,"title":43,"body":63,"description":73,"extension":779,"links":780,"meta":781,"navigation":782,"path":44,"seo":783,"stem":45,"__hash__":784},"docs\u002F2.features\u002F4.kmz-import.md",{"type":64,"value":65,"toc":761},"minimark",[66,70,74,86,99,102,107,110,119,130,140,147,160,163,170,173,205,211,214,237,244,246,250,253,393,396,400,403,475,478,497,503,507,535,541,543,547,561,568,571,573,577,606,613,616,622,625,657,659,663,712,714,718,724,734,745,757],[67,68,43],"h1",{"id":69},"kmz-import-guide",[71,72,73],"p",{},"How to structure a Google My Map so its KMZ export imports cleanly into H2OFlows.",[71,75,76,77,81,82,85],{},"The importer reads pin name prefixes (",[78,79,80],"code",{},"Rapid:",", ",[78,83,84],{},"Put-in:",", etc.) and folder names to map placemarks to rapids, put-ins, take-outs, parking spots, and shuttle drops. Following the conventions below means you can build a reach in Google My Maps and import it with one command — no manual SQL.",[87,88,89],"blockquote",{},[71,90,91,92],{},"Reference implementation: ",[93,94,98],"a",{"href":95,"rel":96},"https:\u002F\u002Fgithub.com\u002Fh2oflows-app\u002Fapi\u002Fblob\u002Fmain\u002Finternal\u002Fkmlimport\u002Fkmlimport.go",[97],"nofollow","internal\u002Fkmlimport\u002Fkmlimport.go",[100,101],"hr",{},[103,104,106],"h2",{"id":105},"two-import-modes","Two import modes",[71,108,109],{},"The importer auto-detects which mode your map uses.",[111,112,114,115],"h3",{"id":113},"mode-a-folder-per-reach-recommended-for-single-river-maps","Mode A — Folder-per-reach ",[116,117,118],"em",{},"(recommended for single-river maps)",[71,120,121,122,125,126,129],{},"Each top-level folder = one reach. The folder name must match a reach's ",[78,123,124],{},"name"," or ",[78,127,128],{},"slug"," (case-insensitive, partial match works).",[131,132,137],"pre",{"className":133,"code":135,"language":136},[134],"language-text","My Map\n├── Browns Canyon                ← matches reach by name\n│   ├── Rapid: Zoom Flume\n│   ├── Rapid: Big Drop\n│   ├── Put-in: Fisherman's Bridge\n│   ├── Take-out: Hecla Junction\n│   └── Parking: Hecla Lot\n└── Royal Gorge\n    ├── Put-in: Parkdale\n    ├── Take-out: Cañon City\n    └── Rapid: Sunshine Falls\n","text",[78,138,135],{"__ignoreMap":139},"",[71,141,142,143,146],{},"The importer matches the folder name against the ",[78,144,145],{},"reaches"," table using:",[148,149,150,154,157],"ol",{},[151,152,153],"li",{},"Exact name match",[151,155,156],{},"Exact slug match",[151,158,159],{},"Substring match (folder contains reach name, or vice versa)",[71,161,162],{},"If no reach matches, the entire folder is skipped with a warning.",[111,164,166,167],{"id":165},"mode-b-category-organized-for-regional-maps-spanning-many-reaches","Mode B — Category-organized ",[116,168,169],{},"(for regional maps spanning many reaches)",[71,171,172],{},"Folders are named by feature type, and the importer infers which reach each pin belongs to. All folder names must come from this set:",[174,175,176,185,196,201],"ul",{},[151,177,178,181,182],{},[78,179,180],{},"Access Points"," \u002F ",[78,183,184],{},"Access",[151,186,187,181,190,181,193],{},[78,188,189],{},"Rivers",[78,191,192],{},"Waterways",[78,194,195],{},"River Lines",[151,197,198],{},[78,199,200],{},"Rapids",[151,202,203],{},[78,204,24],{},[131,206,209],{"className":207,"code":208,"language":136},[134],"Colorado Whitewater\n├── Access Points\n│   ├── Browns Canyon — Fisherman's Bridge put-in\n│   ├── Browns Canyon — Hecla Junction take-out\n│   └── Numbers — Granite Bridge put-in\n├── Rapids\n│   ├── Numbers — Number 5\n│   └── Browns — Zoom Flume\n└── Rivers\n    └── (line strings — currently ignored)\n",[78,210,208],{"__ignoreMap":139},[71,212,213],{},"In category mode, reach assignment happens in two passes:",[148,215,216,227],{},[151,217,218,222,223,226],{},[219,220,221],"strong",{},"Name-based:"," the importer searches each pin's ",[78,224,225],{},"name + description"," for any keyword from a reach name (excluding generic words like \"river\", \"creek\", \"canyon\", \"fork\", \"upper\", \"lower\"). First match wins.",[151,228,229,232,233,236],{},[219,230,231],{},"Proximity fallback:"," any pin that didn't name-match gets assigned to the geographically nearest pin that ",[116,234,235],{},"did"," name-match.",[71,238,239,240,243],{},"This means ",[219,241,242],{},"at least one pin per reach must mention the reach name"," to anchor the others by proximity.",[100,245],{},[103,247,249],{"id":248},"pin-naming-conventions","Pin naming conventions",[71,251,252],{},"The importer reads a prefix off each pin name to decide what kind of feature it is.",[254,255,256,272],"table",{},[257,258,259],"thead",{},[260,261,262,266,269],"tr",{},[263,264,265],"th",{},"Prefix",[263,267,268],{},"Stored as",[263,270,271],{},"Example",[273,274,275,293,316,336,355,374],"tbody",{},[260,276,277,282,288],{},[278,279,280],"td",{},[78,281,80],{},[278,283,284,287],{},[78,285,286],{},"rapids"," row",[278,289,290],{},[78,291,292],{},"Rapid: Zoom Flume",[260,294,295,303,311],{},[278,296,297,181,300],{},[78,298,299],{},"Wave:",[78,301,302],{},"Surf:",[278,304,305,307,308],{},[78,306,286],{}," row, ",[78,309,310],{},"is_surf_wave = true",[278,312,313],{},[78,314,315],{},"Surf: Glenwood Wave",[260,317,318,322,331],{},[278,319,320],{},[78,321,84],{},[278,323,324,327,328],{},[78,325,326],{},"reach_access"," type=",[78,329,330],{},"put_in",[278,332,333],{},[78,334,335],{},"Put-in: Fisherman's Bridge",[260,337,338,343,350],{},[278,339,340],{},[78,341,342],{},"Take-out:",[278,344,345,327,347],{},[78,346,326],{},[78,348,349],{},"take_out",[278,351,352],{},[78,353,354],{},"Take-out: Hecla Junction",[260,356,357,362,369],{},[278,358,359],{},[78,360,361],{},"Parking:",[278,363,364,327,366],{},[78,365,326],{},[78,367,368],{},"parking",[278,370,371],{},[78,372,373],{},"Parking: Hecla Lot",[260,375,376,381,388],{},[278,377,378],{},[78,379,380],{},"Shuttle:",[278,382,383,327,385],{},[78,384,326],{},[78,386,387],{},"shuttle_drop",[278,389,390],{},[78,391,392],{},"Shuttle: Buena Vista",[71,394,395],{},"The colon is required. The text after the colon becomes the feature name.",[111,397,399],{"id":398},"description-based-fallback","Description-based fallback",[71,401,402],{},"If you forget a prefix, the importer tries to infer the feature type from the description text. Keywords it looks for:",[174,404,405,418,431,441,458],{},[151,406,407,81,409,81,412,415,416],{},[78,408,368],{},[78,410,411],{},"can park",[78,413,414],{},"park here"," → ",[78,417,368],{},[151,419,420,81,423,81,426,415,429],{},[78,421,422],{},"take-out",[78,424,425],{},"takeout",[78,427,428],{},"take out",[78,430,422],{},[151,432,433,81,436,415,439],{},[78,434,435],{},"put-in",[78,437,438],{},"put in",[78,440,435],{},[151,442,443,81,446,81,449,81,452,415,455],{},[78,444,445],{},"surf wave",[78,447,448],{},"surf spot",[78,450,451],{},"surfable",[78,453,454],{},"play wave",[78,456,457],{},"wave",[151,459,460,81,463,81,466,81,469,415,472],{},[78,461,462],{},"class",[78,464,465],{},"line is",[78,467,468],{},"boof",[78,470,471],{},"ledge",[78,473,474],{},"rapid",[71,476,477],{},"And as a last resort, the folder name (in category mode) is used as a hint:",[174,479,480,489],{},[151,481,482,181,484,415,487],{},[78,483,200],{},[78,485,486],{},"Waves",[78,488,474],{},[151,490,491,181,493,415,495],{},[78,492,180],{},[78,494,184],{},[78,496,435],{},[71,498,499,500],{},"This is fragile — ",[219,501,502],{},"prefer the explicit prefix.",[111,504,506],{"id":505},"class-ratings","Class ratings",[71,508,509,510,513,514,81,517,520,521,524,525,81,528,81,531,534],{},"If you put ",[78,511,512],{},"Class III+"," (or ",[78,515,516],{},"Class V",[78,518,519],{},"Class IV-",", etc.) anywhere in a rapid's description, the importer extracts it into ",[78,522,523],{},"rapids.class_rating"," as a float (",[78,526,527],{},"3.5",[78,529,530],{},"5.0",[78,532,533],{},"3.75",").",[131,536,539],{"className":537,"code":538,"language":136},[134],"Rapid: Zoom Flume\nDescription: Class IV. Big wave train, river-right line cleanest.\n",[78,540,538],{"__ignoreMap":139},[100,542],{},[103,544,546],{"id":545},"what-gets-replaced-on-re-import","What gets replaced on re-import",[71,548,549,550,560],{},"For each reach the importer touches, ",[219,551,552,553,125,556,559],{},"rapids and access points with ",[78,554,555],{},"data_source = 'import'",[78,557,558],{},"'ai_seed'"," are deleted first",", then re-inserted from the KMZ.",[71,562,563,564,567],{},"This means you can re-export your Google My Map and re-import safely — your latest version replaces the previous one. Rapids and accesses created with ",[78,565,566],{},"data_source = 'maintainer'"," (manually authored, not from a KMZ or AI seed) are never deleted.",[71,569,570],{},"Geometry-only updates are not supported — you must re-import the full reach.",[100,572],{},[103,574,576],{"id":575},"importing","Importing",[131,578,582],{"className":579,"code":580,"language":581,"meta":139,"style":139},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","go run .\u002Fcmd\u002Fimport-kml -file \u002Fpath\u002Fto\u002Fyour-export.kmz\n","bash",[78,583,584],{"__ignoreMap":139},[585,586,589,593,597,600,603],"span",{"class":587,"line":588},"line",1,[585,590,592],{"class":591},"sBMFI","go",[585,594,596],{"class":595},"sfazB"," run",[585,598,599],{"class":595}," .\u002Fcmd\u002Fimport-kml",[585,601,602],{"class":595}," -file",[585,604,605],{"class":595}," \u002Fpath\u002Fto\u002Fyour-export.kmz\n",[71,607,608,609,612],{},"Add ",[78,610,611],{},"-dry-run"," to see what would be imported without touching the database.",[71,614,615],{},"The importer prints a per-reach summary and a log of every pin it processed:",[131,617,620],{"className":618,"code":619,"language":136},[134],"Browns Canyon: 12 rapids, 1 put-in, 1 take-out, 2 parking\nRoyal Gorge:    8 rapids, 1 put-in, 1 take-out\n\n✓ [Browns Canyon] rapid: Zoom Flume\n✓ [Browns Canyon] put-in: Fisherman's Bridge\n~ \"Hecla Lot\" → Browns Canyon (by proximity)\n⚠  folder \"Numbers\" — no matching reach, skipping\n",[78,621,619],{"__ignoreMap":139},[71,623,624],{},"Symbols:",[174,626,627,633,639,645,651],{},[151,628,629,632],{},[78,630,631],{},"✓"," — pin imported successfully",[151,634,635,638],{},[78,636,637],{},"~"," — pin assigned to a reach by proximity (not by name)",[151,640,641,644],{},[78,642,643],{},"↺"," — previous import data cleared for this reach",[151,646,647,650],{},[78,648,649],{},"⚠"," — warning, pin or folder skipped",[151,652,653,656],{},[78,654,655],{},"✗"," — error during insert",[100,658],{},[103,660,662],{"id":661},"tips-for-clean-google-my-maps","Tips for clean Google My Maps",[174,664,665,671,677,683,696,702],{},[151,666,667,670],{},[219,668,669],{},"One reach per folder"," is the easiest mode. Use it unless you really need a regional overview map.",[151,672,673,676],{},[219,674,675],{},"Prefix every pin."," Don't rely on description-based inference.",[151,678,679,682],{},[219,680,681],{},"Anchor at least one pin per reach with the reach name"," in category mode, so proximity matching has something to grab onto.",[151,684,685,688,689,125,692,695],{},[219,686,687],{},"Don't use generic words alone"," as folder names — ",[78,690,691],{},"River",[78,693,694],{},"Creek"," won't match anything.",[151,697,698,701],{},[219,699,700],{},"Line strings (river centerlines) are ignored"," by the importer. Reach geometry comes from OSM via the centerline fetcher, not KMZ.",[151,703,704,707,708,711],{},[219,705,706],{},"Re-export and re-import freely."," It's idempotent for ",[78,709,710],{},"import","-sourced data.",[100,713],{},[103,715,717],{"id":716},"troubleshooting","Troubleshooting",[71,719,720,723],{},[219,721,722],{},"\"folder X — no matching reach, skipping\"","\nThe folder name doesn't match any reach. Check spelling, or rename the folder to match the reach's slug exactly.",[71,725,726,729,730,733],{},[219,727,728],{},"\"Y — no anchors, skipping\""," ",[116,731,732],{},"(category mode)","\nNo pin in the map name-matched a reach, so proximity fallback has nothing to work from. Add a pin whose name explicitly contains the reach name.",[71,735,736,739,740,181,742,744],{},[219,737,738],{},"\"unknown type, skipping\"","\nThe pin had no prefix and the description didn't match any inference keyword. Add an explicit ",[78,741,80],{},[78,743,84],{}," \u002F etc. prefix.",[71,746,747,750,751,753,754,756],{},[219,748,749],{},"Pins disappeared after re-import","\nExpected — ",[78,752,710],{},"-sourced rows are cleared before each re-import. If you want a pin to survive, set its ",[78,755,566],{}," manually in the database.",[758,759,760],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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);}",{"title":139,"searchDepth":588,"depth":762,"links":763},2,[764,771,775,776,777,778],{"id":105,"depth":762,"text":106,"children":765},[766,769],{"id":113,"depth":767,"text":768},3,"Mode A — Folder-per-reach (recommended for single-river maps)",{"id":165,"depth":767,"text":770},"Mode B — Category-organized (for regional maps spanning many reaches)",{"id":248,"depth":762,"text":249,"children":772},[773,774],{"id":398,"depth":767,"text":399},{"id":505,"depth":767,"text":506},{"id":545,"depth":762,"text":546},{"id":575,"depth":762,"text":576},{"id":661,"depth":762,"text":662},{"id":716,"depth":762,"text":717},"md",null,{},true,{"title":43,"description":73},"jtabb_z3N9KvgSDwHlscEEf94J3993kLXKy3hu4oMU0",[786,788],{"title":38,"path":39,"stem":40,"description":787,"icon":41,"children":-1},"River reach detail pages — rapids, access points, gauges, and conditions.",{"title":52,"path":53,"stem":54,"description":789,"icon":55,"children":-1},"H2OFlows system architecture — backend, frontend, data model, and hosting.",1778705156241]