Geodesic Solutions Community Wiki

User Tools

Site Tools

You are here: Auction and Classified Software Support Home » Addons » Google Maps » First Time Configuration
addons:google_maps:install:start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
addons:google_maps:install:start [2015/02/09 18:33]
geojames 		addons:google_maps:install:start [2018/12/05 17:33] (current)
geojames
Line 1: Line 1:
 ====== First Time Configuration ====== ====== First Time Configuration ======
  
-These are the instructions to follow in order to start using Google Maps on your site.+These are the instructions to follow in order to start using Google Maps on your site.  We've had to change these instructions several times as Google updates their admin tools from time to time and also seem to be moving all their services into their cloud platform.  So let us know if these change.
  
-  - If you do not yet have a Google Maps API Key visit the Google APIs Console at https://code.google.com/apis/console and log in with your Google Account (or create a Google Account if you do not already have one). +  - Create a cloud account on the Google Cloud Platform.  You can probably use the same account attached to your other "Google offerings".  You may have one setup already.  The url we see within our account is https://console.cloud.google.com. 
-    -**Newer Google Developers Console View**: Click the "Enable an API" button you see in the Google "Project Dashboard" page and then scroll down and click on "Google Maps Embed API"as seen below: {{ :addons:google_maps:install:google_maps_config1.png?500 }}. Toggle the "on/off" switch you see there to the "on" position as seen here: {{ :addons:google_maps:install:google_maps_config2.png?500 }}.  Once "on" you would go to the "Credentials" page in the "APIs & auth" section of the left hand menu.  Many times you are asked the type of key to choose.  Choose "browser key" if you do see this option.  Use the API KEY shown there: {{ :addons:google_maps:install:google_maps_config3.png?500 }} +  - Once within your Google Cloud Platform account we suggest creating a project for your site if not just for Google Maps for your site.  Click the highlighted project chooser within the following: {{ :addons:google_maps:install:google_maps_1.png?600 }} 
-    -**Older Google Developers Console View**: Services link from the left-hand menu, then activate the **Google Maps API v3** service (**not** the "v2" service).  If your v2 API service is on you should turn it off.  Once the service has been activated, your API key is available from the **API Access** page, in the **Simple API Access** section. Use the **Key for browser apps.**+  - Within the next popup screen choose the "new project":  {{ :addons:google_maps:install:google_maps_2.png?600 }} 
 +  - Within the next screen name your project, add it to a organization if you have or want one and click the create button:  {{ :addons:google_maps:install:google_maps_3.png?600 }} 
 +  - Once that project is added click the "project select" you chose in the first step, choose the new project name you just created and click the "open" button at bottom. 
 +  - Within the next screen search for "maps" within the search box provided 
 +  - Within the search results click the "Maps Javascript API" as shown here:  {{ :addons:google_maps:install:google_maps_4.png?600 }} 
 +  - Click the "Enable" button within the next screen. 
 +  - Now you are in the project home of the project you just created with Maps Javascript API details showing as below...click the APIs link in the left window:  {{ :addons:google_maps:install:google_maps_5.png?600 }} 
 +  - Now you should see a full list of APIs currently enabled on your new project.  You will need to enable the "Geocoding API" also for this same project as you see in this screenshot.  When done you should see the "Maps Javascript API" and the "Geocoding API" enabled for this project. 
 +  - Within the Google Cloud Platform choose the "APIs & Services" link within the left menu. 
 +  - Next click the "credentials" link within the left window. 
 +  - You should see a "create credentials" link in the middle of the page if you have not created API credentials for this project yet. 
 +  - You should see a popup with the newly created API key.  Click close and you will see all API credentials in your current project.  That API key is what you will use within your Geo Google Maps addon admin tool.  You can additionally click on the API key in the list to put restrictions on it's use....like only for your website's url or others.  If you put restrictions just make it so it can work on the site your Geo installation is on.
   - Install and enable the Google Maps addon if you have not already, following [[addons/install/start]]. <   - Install and enable the Google Maps addon if you have not already, following [[addons/install/start]]. <
   - In your admin panel, go to [[admin_menu/addons/google_maps/settings/start|Addons > Google Maps > Settings]], and enter your Google Maps API key. Save the settings. <   - In your admin panel, go to [[admin_menu/addons/google_maps/settings/start|Addons > Google Maps > Settings]], and enter your Google Maps API key. Save the settings. <
   - Change the rest of the setting if you wish to change them from the defaults. <   - Change the rest of the setting if you wish to change them from the defaults. <
   - At the bottom of that same page in your admin, after the settings have been saved, ensure that the Google Map Preview displays correctly in the [[admin_menu/addons/google_maps/settings/start#Maps Preview]] section.  If it does not, check the settings and that cURL is working on your server, if the map does not display here it will not display on listing details pages. <   - At the bottom of that same page in your admin, after the settings have been saved, ensure that the Google Map Preview displays correctly in the [[admin_menu/addons/google_maps/settings/start#Maps Preview]] section.  If it does not, check the settings and that cURL is working on your server, if the map does not display here it will not display on listing details pages. <
-  - Add the tag **{addon author='geo_addons' addon='google_maps' tag='listing_map'}** to your classified details and auction details templates, which ever is appropriate for your software product. If using a template set design based on the default design from 5.0+, the template file(s) you will need to edit are **listing_classified.tpl** and/or **listing_auction.tpl** template(s). Within these templates you would insert this tag where you want the Google Maps addon to appear in your listing details page.< +  - [NOTE: in most cases, this step is done for you automatically] Add the tag **{addon author='geo_addons' addon='google_maps' tag='listing_map'}** to your classified details and/or auction details templates (generally, listing_classified.tpl or listing_auction.tpl). If not already present, you would insert this tag into these templates wherever you want the Google Map to appear.< 
-  - In [[admin_menu/listing_setup/fields_to_use/start|Listing Setup > Fields to Use]] make sure to allow using the following fields: +  - In [[admin_menu/listing_setup/fields_to_use/start|Listing Setup > Fields to Use]] make sure to allow using the **Mapping Location** field
-    * Mapping Location((Note that this is the only field as of version 7.0.  If you have previous version, you will have several different mapping fields that are combined together to form the location that is used to map the listing.)) <+
 < <
   - Place a test listing on your site, and be sure to enter the mapping data.  Once the listing is placed, view the listing details to see if the map displays. <   - Place a test listing on your site, and be sure to enter the mapping data.  Once the listing is placed, view the listing details to see if the map displays. <
  
-<tip cn>Make sure you test/use this feature with an actual address that can be found by the Google Maps site.  If the address is not a good address the window may never appear</tip>+<tip cn>Make sure you test/use this feature with an actual address that can be found by the Google Maps site.  If the address is not valid, the window may never appear</tip>
addons/google_maps/install/start.1423506831.txt.gz · Last modified: 2015/02/09 18:33 by geojames

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
CC Attribution-Noncommercial-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki