From eab504c88c869efbbbf8292940e4e5770f96cb06 Mon Sep 17 00:00:00 2001 From: Andrea Buntz Neiman Date: Fri, 9 Apr 2021 10:50:10 -0400 Subject: [PATCH] Docs: Sort by Geographic Proximity Signed-off-by: Andrea Buntz Neiman Signed-off-by: Galen Charlton --- .../admin_initial_setup/pages/geosort_admin.adoc | 97 +++++++++++++++++++++ .../opac/assets/images/media/geosort_entry_box.PNG | Bin 0 -> 4638 bytes .../assets/images/media/geosort_results_km.PNG | Bin 0 -> 13025 bytes .../images/media/geosort_retrieval_error.PNG | Bin 0 -> 3509 bytes 4 files changed, 97 insertions(+) create mode 100644 docs/modules/admin_initial_setup/pages/geosort_admin.adoc create mode 100644 docs/modules/opac/assets/images/media/geosort_entry_box.PNG create mode 100644 docs/modules/opac/assets/images/media/geosort_results_km.PNG create mode 100644 docs/modules/opac/assets/images/media/geosort_retrieval_error.PNG diff --git a/docs/modules/admin_initial_setup/pages/geosort_admin.adoc b/docs/modules/admin_initial_setup/pages/geosort_admin.adoc new file mode 100644 index 0000000000..a06bd90cd4 --- /dev/null +++ b/docs/modules/admin_initial_setup/pages/geosort_admin.adoc @@ -0,0 +1,97 @@ += Sort by Geographic Proximity: Configuration + +indexterm:[Geographic Sort,Search Results,Searching] + +:toc: + +The sort by geographic proximity feature allows library patrons to sort +holdings within a bibliographic record by geographic distance. This +feature requires a 3rd party geographic location service in order to +function. Each Evergreen instance will need to secure its own geographic +location service. + +The feature is controlled by three new Library Settings, a new Global +Flag, two new permissions, and a new interface to configure Geographic +Location Services. Fields to store latitude and longitude have been +added to the *Org Unit Configuration* (/eg2//staff/admin/server/actor/org_unit) page. + +== Library Settings + +* *Enable Holdings Sort by Geographic Proximity* - if this is unset it +will default to FALSE. If set to TRUE, the record details page will +display the address search box to enable proximity sort. The global flag +*opac.use_geolocation* must also be enabled. +* *Geographic Location Service to use for Addresses* - This setting +specifies which geographic location service to use for converting +address input to geographic coordinates. Geolocation Services are +configured via *Server Administration → Geographic Location Services +Configuration* interface. The value used in this is what is entered in +the *Name* field of the Geographic Location Services Configuration. +* *Show Geographic Proximity in Miles* - If set to TRUE, this setting will +force the OPAC to display distance in miles. If this is unset it will +default to FALSE, and the OPAC will display distance in kilometers. + +== Global Flag + +Navigate to *Server Administration → Global Flags* and locate the +opac.use_geolocation flag. Select the *Enabled* checkbox to enable this +flag. This flag must be enabled in order for proximity sort to work. The +*Value* box does not need an entry and in fact any entry in that box +will be ignored. + +== Permissions + +Two new permissions, VIEW_GEOLOCATION_SERVICES and +ADMIN_GEOLOCATION_SERVICES, control viewing and editing values in the +Geolocation Location Services interface. They are added to the System +Administrator and Global Administrator permissions groups by default. + +== Geographic Location Service Configuration + +There is a new administrative interface located at *Server +Administration → Geographic Location Service* +(/eg2//staff/admin/server/config/geolocation_service) which +allows administrators to add and configure new geographic location +services and parameters + +Click the button *New Geographic Location Service* to add a service to +this table. Fields in the modal are: + +* _API Key_ - Provided by your geographic location service provider in +order to authenticate against their service +** Note that HTTP referrers will not work with this feature, but IP address restrictions will. +* _Active_ - Specifies whether this particular location service is active +or not. +* _ID_ - This is automatically generated by the system. +* _Name_ - Enter a name for this service in the Library Setting +*Geographic Location Service to use for Addresses*. Since this value is +translatable, if you give it a translation the Library Setting will +automatically update to the translated value. +* _Owner_ - Indicates which branch owns this service. This gives context +to the two new permissions noted above but does not otherwise affect the +* _Service Code_ - Determines which perl module to use for geocoding. +Valid values are Free, Google, or OSM. +** As of 2021, the perl module 'Google' uses the https://metacpan.org/pod/Geo::Coder::Google[GeoCoder v3 API]. Administrators are strongly advised to review the current Google API documentation. + +You will assign Service Providers to specific Organizational Units using +the Library Setting *Geographic Location Service to use for Addresses*. + +== Other Administration + +The feature makes use of the latitude/longitude of each location’s +physical address, as set in the *Org Unit Configuration* +(/eg2//staff/admin/server/actor/org_unit) page. There is a new +pair of fields to contain Latitude and Longitude as well as a button +which will use the physical address to calculate values for these two +fields. + +Navigate to *Server Administration → Organizational Units*. Select the +relevant Organizational Unit from the tree on the left, select the +*Addresses* tab, and then select the *Physical Address* subtab. You may +manually enter Latitude and Longitude values, or select the *Get +Coordinates* button to generate coordinates from the address entered in +the Physical Address subtab. Click the *Save* button to save your +changes. + +The latitude and longitude values are available in the *Org Address* +reporting source. \ No newline at end of file diff --git a/docs/modules/opac/assets/images/media/geosort_entry_box.PNG b/docs/modules/opac/assets/images/media/geosort_entry_box.PNG new file mode 100644 index 0000000000000000000000000000000000000000..1642626b409bd1a63887c2daead2d173f095f454 GIT binary patch literal 4638 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 F{{;d=yDb0! literal 0 HcmV?d00001 diff --git a/docs/modules/opac/assets/images/media/geosort_retrieval_error.PNG b/docs/modules/opac/assets/images/media/geosort_retrieval_error.PNG new file mode 100644 index 0000000000000000000000000000000000000000..2491cdaace1f48b0a28d2accb6f4728cc9b92ab6 GIT binary patch literal 3509 zcmd6q`#;lfAICq|usg}Pg@l>9sU*iDVov+g_nUJ?awgxRayHCpm_usw?ORcibRfx` zk~1SL$Ejq_n;a%%LuPC?_rCZ2!~J;N|G<6!a2?*)>;1T{_w{&RkH__VXE{6CN$*wO z3jl!hIeS}I003b{b9ab@s7IF-z7!2&QLc8@0C7;|hsXf`ZslMF096F39e;6={kL%Y z%TWLz7yVZgn+}G>iFW$+oUPS`IG>eC1VP?TnH-Ter}&+of5N75z9wf|Tq zRbtE0l9~|!ftGKl@&~1uA7s&xB1rz!zOc%!2Tbx#Z7O^ z-cAftPSs2%Qs35AFR_5Tl{a;U4YqKT5kBl71abej(C z3aPaxi3DN=kpj@6ATd8N#o`Z8VRQsW69NhsU8C~$#Kjux5rsQUGvF^BtHS~nf9LH7 z(kuZF(q8u~#{o-7=jX{5bguQ-jnD7=YF~pynhLHq6LjT8p})4r%~Ak>L+z{}og=a! zv3zA~b$kjmv-~g^WO7R6C=Q2Sv4eoaLm*g_z1Hd<@K6YS7z&DzPqVzC3Wt(P;o$E_ zA=uHz)HG5yA|SMbU$WVttq9b6K@w5ZQ`=-jlN0hxQzlsUA({xuZH52ynSMGfE5`5L0ySjOgHFEe&)=bMGHnT;SwHa90tfB5;X330iOyCV!g@2hyz(-&#I zZ`3MN~Jli4a06LwSCPYY2M)7@0N^_ewB$(omH zxNwO=NqCfD2?H)}WfiRsZf9(D3yHr$CZ}Sgv9LxhUvJFTZy|6!T*HYsEtt`%MnR?T zea)?$*fMmUa5jn|QxOR4SO_HLK{Ta}4(3e4<*8>O6WodsMI-+K=oU#po2Rv*Xi8*P z=nj)Z>8|4ZdJIfbB+UP*W;3Hm;I+9_5**S<+K~qE)!Rf2B!B#vHch5oXT`qf_Tpem zRFZ|tE+v^m)8j`e)U{wgG5^wx4-EP3h zwtrFmGw=~7rFr1&gLM7<(U^12C@=)z(yj0(nCZS?33@sO&Wz<~+mbS{KR0N1}AYbj_&x<2L9KDJ*=hrLhu^ zTc-=i!Zd=pIRfN z)UX`hecy7{`@2ye(j{Z$aZ+hj&*mKq&zb%@*@;c$z{S{|cj!_clbnaAF$vt{VrG47 z^Ku1jsU-GW-0;qpup}_VB9v?p;d?Da*SCiQ3*(daU)^@3BOw8tf@0{t zZofxu`^ApXkU!ZDtnSx!Scbg$E-C;w-0b3CB6tRZ^D;B@4&E zook7-5j{24pn0aj9PfiB<9I&eE@kxfKt;JPxnZ#TF}Ed2kgp2z-in-gyD#PzcjZ!Y z|Bihu+qoD8diZ#A^lxc3o{$aNo=NtsPg~R|X8D;=j>ezoijrE;2X1%u3M!Lw^7@n> zHO#Ef>6z-RH0i^+vr}-VgHc^O8fA*~jfC8!`Rum+*sCVc@Ac7z88|PP6IMMmc^SR; ziUD|`Nc+7mqiV4NBD)^5;$hX_C**VsU!hGms082sl7y8BwWW}esA~wrZBFM-57iK} z_S5vP;WTw7ZaLfH887&(dlu|vf<+07G5IsfK9}d{2a!Ih)T!~&Nmu5#KV*>bYaV0) z+7PZM^~_?j(@!Ir)sUlMLkRM|lCB&-sX|tl!M<*$Aj9ut6r$Yp_S{?wpt zOgp1ZP{bJXgA8rxl@spimTiYn=zTsjhi8?*m}|`B&E(>oYqn8iQ*krFWO z&uEhxo@PY>SI6t{T}oq8ysB^V8^iQcPssa)!=G2~T@ATw2(N_TuuNYaaBvaN6+R?h z`M$|Lopj$s3x|-E<8Zg$H%v8uKTPlMchq4G)k9=O$qvCHcg+X-E3 z53T8Vtakl0dzpx?)vMJC9_p&$67~bqpoV$|bq~|V^b*B z>Q!6j^y8Fe<;rJ;Eg_Kp)GXCoNz2bRR`LYd??U@-Uy|{zh8ck0(&tyyK=YIGA>{Lh z@S!Jt%dL;dR4ME%xe~c%)i)k51=nq6;F*?M*3SzPJSU1zybh0{-e zWIvHi?r#h;{CAF)+LZ2Rp*_D6m}OW4KVSRRi1|k;U5%J%woDSUKc(u!P`kK6 zT|Cm{@eg;E38+LOf;`K~`TR9IZi(+~hZ8qHebJXt`*>yi<9y?{Z`t<_Pi6QW|B9!MJ^r8&N5v z0H1qx9|zWzFrJN*CFU17Xis*MV$}9L)&2#dKT-Qh$Yt=8ExI6B!A)3)*U|XAb*u7Z z8o^%t%>D7l-`SiDTi^^BpdH>Y>1?M;a` zPsVQ!H^q(VK72qW*40pmDhQ-h=+EftFsD z+gz;I9d8Z4KO##g(+|zPOAdf$xx7*F<|Gj|np)F6zmUVwtPigUeWT)?PpS!bCeW>p z>$84di2p)NQ)~6xZZ?ok7bvJIM#Q%z>CnuV>fivTh=U!a|BGR}bzaE#Udj#@FVi^y zsDnWy(51?8S1~}u`6vATvsjqOe|?bn!P$!@c3V^kNF{E5MFo?_ts^j!|8fmqV=x_9 z5{(v3t$Re63@AkU_pZFX3E$Uf(by^nh#e8d0o;}lkuv}&+d{wqa1APQ1D;#`Zv;oG a0QRl5^un-0)+bSo1Dr!T+7hk(QvM0kVT30D literal 0 HcmV?d00001 -- 2.11.0