Gazetteer running out of Docker.

 now better documented as far as various options for interacting with gaz data.

Examples/Docker/README.md

@@ -1,12 +1,13 @@
-Xponents Xlayer Docker Image
+Xponents REST Docker Image
 -------------------
+NOTE: "Xlayer" name is being deprecated in favor of simply "Xponents REST".
 
 **Build:**
 
 Copy this Dockerfile to the Xponents ./dist folder and build the docker image with the Xponents-X.x build in that folder.
 
 
-```
+```sh
 # This below produces a build of Xponents with Xlayer server scripts packed in.
 #
 cd Xponents/script
@@ -20,13 +21,30 @@ XPONENTS_VERSION=3.2
 docker build . --tag opensextant:xponents-$XPONENTS_VERSION
 
 ```
+This default build provides only a running Xponents REST service.  The Solr Gazetteer (default port 7000) is not running, but see below if you wish to run them together.  For heavy production use, it is better to keep these separate -- data processing vs. rote reference data lookups.
 
+**Run Xponents REST:**
 
-**Run:**
 Choose a port number -- XLAYER_PORT is the only argument to the internal "xlayer-docker.sh" script.
 Leave off `--detach` if you want to see console.
 Use `docker logs NAME` to see the console, if it was a detached run. NAME is the docker container "--name" argument.
 
-```
+```sh
 docker run -p 8888:8888 -p 7000:7000 -e XLAYER_PORT=8888 --name xponents --rm --detach  opensextant:xponents-3.2
 ```
+
+**Run Gazeteeer:**
+
+```sh
+docker exec -it xponents /bin/bash -c "cd ./xponents-solr && ./solr7-dist/bin/solr start -p 7000 -s ./solr7 -m 3g -q -force"
+```
+
+Now that you have the Gazetteer running, you can query this in various ways:
+
+* Python client, as illustrated by `gazetteer.py`: https://github.com/OpenSextant/Xponents/blob/master/Examples/script/gazetteer.py, which requires the service URL as the `--solr URL` argument.
+* Java API, as illustrated in the Xponents demo in the SDK: `./script/xponents-demo.sh gazetteer --help`. This does not need to the Solr server running; just listing this here for completeness.
+* Direct Solr Gazetteer access, which provides a standard Solr search experience. For example in this example the query is getting at "places with Boston in the name, within 50KM of the lat/lon (40, -71), listing results as CSV":
+http://localhost:7000/solr/gazetteer/select?q=name%3ABoston%20AND%20{!geofilt%20sfield=geo%20d=50%20pt=40.0,-71.0}&wt=csv
+
+
+