#788 Add flags for poi search, update documentation.

[CTJeffries]

Added flags to geserveradmin to allow publishing databases with POI search information. Updated the documentation of geserveradmin to reflect these new flags.

Automatic testing these changes would require rewriting PublisherClient.cpp, and testing the command line utility itself would require an additional testing framework outside of gtest. Because of the lack of automatic testing, manual test instructions are included below.

To test POI search flag for geserveradmin:

Create a test database, my test database used the 4km bluemarble imagery data and the California population vector data. Add POI information making sure it is searchable, I added the names of the cities.

Test 1) Publish the database using:
geserveradmin --publishdb <db_name> --targetpath <publish_name>
Upon command success, open up the earth client. Try to search something, you should get no results as POI search is not enabled. Unpublish the database using either console commands or the geserver webpage.

Test 2) Publish the database using:
geserveradmin --publishdb <db_name> --targetpath <publish_name> --enable_poisearch
Upon command success, open up the earth client. Search for something that is in your POI data (In my case I search "san", as there are many cities in California with "san" in their name). You should get results that are only in your database. Unpublish the database using either console commands or the geserver webpage.

Test 3) Publish the database using:
geserveradmin --publishdb <db_name> --targetpath <publish_name> --enable_poisearch --enable_enhancedsearch
Open up the earth client. Search for something that is not in your POI data, perhaps a city in the US (In my case I search "Wooster", as there is no city in California called Wooster, but there are a few scattered throughout the rest of the US). You should get results for data outside your database using the GeocodingFederated plug-in. Unpublish the database using either console commands or the geserver webpage.

Test 4) Attempt to publish the database using:
geserveradmin --publishdb <db_name> --targetpath <publish_name> --enable_enhancedsearch
You should get a fusion fatal error, indicating that you cannot enable enhanced search without POI search being enabled.

Fixes #788

[googlebot]

Thanks for your pull request. It looks like this may be your first contribution to a Google open source project (if not, look below for help). Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

📝 Please visit https://cla.developers.google.com/ to sign.

Once you've signed (or fixed any issues), please reply here (e.g. I signed it!) and we'll verify it.

---

What to do if you already signed the CLA

Individual signers

• It's possible we don't have your GitHub username or you're using a different email address on your commit. Check your existing CLA data and verify that your email is set on your git commits.

Corporate signers

• Your company has a Point of Contact who decides which employees are authorized to participate. Ask your POC to be added to the group of authorized contributors. If you don't know who your Point of Contact is, direct the Google project maintainer to go/cla#troubleshoot (Public version).
• The email used to register you as an authorized contributor must be the email used for the Git commit. Check your existing CLA data and verify that your email is set on your git commits.
• The email used to register you as an authorized contributor must also be attached to your GitHub account.

[CTJeffries]

I signed it.

[googlebot]

CLAs look good, thanks!

[tst-lsavoie]

@CTJeffries the docs that need to be updated are located at https://github.com/google/earthenterprise/blob/master/docs/geedocs/5.2.5/answer/3481558.html. There's a section on geserveradmin that needs to have the new parameters added.

You may need to rebase your branch on the latest master to get access to the 5.2.5 version of the docs. Ping me if you'd like help with that.

[CTJeffries]

Changes to the documentation have been added, along with the addition requested check.

[tst-rwildes]

Nice clean code. I'm approving the PR. Did not test.

[tst-lsavoie]

Reviewed and tested - everything looks good. Good work!

[tst-nfarah-zz]

we need to add this enhancement to release notes of 5.2.5: https://github.com/google/earthenterprise/blob/master/docs/geedocs/5.2.5/answer/7160006.html