Previously, “Google” maps was the only option available that could be integrated with ClassiPress. After feedback from our valued customers and the recent cost associated with Google maps, the App Themes team has worked on adding additional Geo Services.

Each Geo Service is available as an addon extension. This allows you to set up maps on your ClassiPress site with a Geo Service of your choosing.

Configuring Basic Geo Services

Geo Services can be found within their own menu.

1. Click on ClassiPress and then on the Geo Services menu.
2. Depending on which free/paid Geo Services Addons you have, you may see only one page, or you may see a number of different tabs.
3. Under the General tab is where the basic Geo Services configuration will take place.
4. Choose your Geocoder Provider from the drop-down menu. The options, other than Google will relate to the Geo Service Plugins you have.
5. Choose the Distance Unit that suits your site, either Kilometers or Miles.
6. Enter a Search Radius. Leaving this field blank will mean the radius will be automatically calculated based on location query.
7. Choose a Maps Provider. The options available will be the direct result of the addons you have on your site.

Setting Up Google Geocoder and Maps

If you decide to use Google as the Geocoder and maps provider of your ClassiPress site, the following section will help you to set it up correctly.

1. Click on the Geocoder – Google tab.
2. Choose your Region Biasing. For example, ‘US’ for the United States or ‘IT’ for Italy. This helps to locate where your customer is posting an ad from.
3. Choose you Language Code.  For example, entering in ‘EN’ represents English. This will be the language used to display locations and other information on the map.
4. Choose the Distance Unit – either Kilometers or Miles.
5. Enter in your Google Maps API Key. You can read further information on setting up your Google API Keys here.
6. Click the Save Changes button.
7. Click on the Maps – Google tab.
8. Complete steps 2 – 5 within this tab.
9. Choose a maps Color Scheme.

Definitions Relating to Geo Services for AppThemes

Installed Geocoder Providers: This option determines which “Geocoder” will be used for the AppTheme. A geocoder takes a given address and converts it to geographic coordinates. All available installed geocoders will be listed in the “Providers” drop down box. Google is the default provided with the theme and the only option available without the addition of a plugin.

Distance Unit: Allows you to select Kilometers or Miles as the desired unit of distance for your site.

Default Standard Location Search Radius: Sets the default value for search radius when searching by location in the AppTheme. For example, if a user searches for a Listing/Event in Toledo, Ohio, then the search result will display listings or events within 100 miles radius on Toledo. If the “Distance Unit” was set to kilometers, then the search radius would be 100km.

Map Provider: This setting allows you to select the Map Provider used to display maps on your AppThemes site. Google Maps is the default Map Provider provided with the theme and the only option available without the addition of a plugin.

Disabling Geo Services for ClassiPress

If for any reason you do not wish to display maps on your ClassiPress website you can use the following section to disable maps and geocoder services.

How Can I Disable Geo Services on my ClassiPress Site?

If you wish to disable Geo Services, follow the instructions below:

1. Click on the ClassiPress menu and then on Geo Services.
2. Within the General tab, you will see a drop-down menu for the Geocoder Provider and for the Maps Provider.
3. Choose the word “Disabled” from both drop-downs if you wish to disable Geocoder and maps or just from the provider you wish to disable.
4. Ensure you Save Changes.

What Will Happen if I Disable Maps on my ClassiPress Website?

1. The map will disappears from the Ad sidebar.
2. The link to Google Maps site is still there while the ad still has coordinates.
3. Search location autocomplete will be disabled with the map.
4. Location field will still appear and will accept addresses for location search.
   • If Geocoder is enabled – it will do request from the backend on the page load. This will work similarly as how it works with auto-suggest, except it will automatically take the first available address option (regardless it correct or not).
   • If Geocoder is disabled – it will search for given location value in the ad Country, State, City, Postal Code and Street values.

What Will Happen if I Disable Geocoder on my ClassiPress Website?

1. Geo-coding on ads import/create/edit will not work.
2. Ads will not have coordinates. There will be no link to the Google maps site.
3. Location search using auto-suggest and Geocoder will not work for such ads (they need ad coordinates).
4. Search by location will still available, but it will search for given location value in the Ad Country, State, City, Postal Code and Street values.

Bing Maps Example

Google Maps Example

Related Documentation:

• Setting Up Google Maps API Keys