Instructions for connecting the Google Maps API: Difference between revisions

From Planfix
Jump to: navigation, search
No edit summary
No edit summary
 
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
The Google Maps API is used to transform data containing addresses or location names from text to a data type designed for displaying objects on a map. This feature is used in the Planfix integration with maps.
The Google Maps API is used to transform data containing addresses or location names from text to a data type designed for displaying objects on a map. This feature is used in the [[Maps Integration | Planfix integration with maps]].


To connect this integration, you will need to have a Google account (or you will need to create one).
To connect this integration, you will need to have a Google account (or you will need to create one).
Line 42: Line 42:




This key is required when connecting the Planfix [[maps integration]].
This key is required when connecting the Planfix [[Maps Integration | maps integration]].




Line 49: Line 49:
To use the integration, you must connect a Google payment account to the project you created. If you don't have a payment account, you can create a new one by following the instructions below.
To use the integration, you must connect a Google payment account to the project you created. If you don't have a payment account, you can create a new one by following the instructions below.
   
   
Important: At the time when this article was written, Google was offering new customers a $300 credit to spend on Google Cloud Platform products during their first year. All you need to do to get the bonus is create a new payment account and enter your credit card information. There will be no automatic payments made with your card; it's used so Google can make sure you're not a robot.
'''Important:''' At the time when this article was written, Google was offering new customers a $300 credit to spend on Google Cloud Platform products during their first year. All you need to do to get the bonus is create a new payment account and enter your credit card information. There will be no automatic payments made with your card; it's used so Google can make sure you're not a robot.
 
   
   
Steps for creating and connecting a payment account:
Steps for creating and connecting a payment account:
●      In the main menu (the "hamburger") select Payment:
*In the main menu (the "hamburger") select '''Billing''':


   
   
<screenshot>
https://pic.planfix.ru/pf/GX/IOIGXb.png
   
   
●      Click Configure account in the window that appears:
 
*Click '''Manage billing accounts''' in the window that appears:


   
   
<screenshot>
https://pic.planfix.ru/pf/Fp/hSImqk.png
   
   
●      Click Add payment account:
 
*Click '''Add billing account''':


   
   
<screenshot>
https://pic.planfix.ru/pf/kC/YkeKIH.png
 
   
   
●      Select your country and agree to the terms of the free Google Cloud Platform trial period:
*Select your country and agree to the terms of the free Google Cloud Platform trial period:


   
   
<screenshot>
https://pic.planfix.ru/pf/WA/nZNGvV.png
 
   
   
●      On the next screen, fill out your contact information and credit card details.
*On the next screen, fill out your contact information and credit card details.
●      Once you've saved this information, the payment account you created will be linked to the project you created earlier.
*Once you've saved this information, the payment account you created will be linked to the project you created earlier.


   
   
Step 3. Connecting libraries
 
==Step 3. Connecting libraries==
To get the integration working correctly, you must connect the following APIs from the Google API library:
To get the integration working correctly, you must connect the following APIs from the Google API library:
●      Maps JavaScript API
*Maps JavaScript API
●      Geocoding API (for transforming addresses into coordinates)
*Geocoding API (for transforming addresses into coordinates)
●      Directions API (for building routes)
*Directions API (for building routes)
●      Places API (for suggestions when entering an address into a field)
*Places API (for suggestions when entering an address into a field)


   
   
To connect them, go to the API and services / Library section of the main menu (the "hamburger"):
To connect them, go to the '''API and services / Library''' section of the main menu (the "hamburger"):
   
   
<screenshot>
https://pic.planfix.ru/pf/V1/19ClMG.png
 
   
   
●      Enter the name of the API you're looking for in the search bar (copy it from the list above):
*Enter the name of the API you're looking for in the search bar (copy it from the list above):


   
   
<screenshot>
https://pic.planfix.ru/pf/Yt/BYvgds.png
 
   
   
●      Click the block for the API you want, and then click Enable:
*Click the block for the API you want, and then click '''Enable''':


   
   
<screenshot>
https://pic.planfix.ru/pf/zJ/y2uwnZ.png
   
   
●      Repeat these steps for each of the APIs in the list above.
 
*Repeat these steps for each of the APIs in the list above.


   
   
Once you've connected all of the required APIs, you can move on to enabling the integration with maps in the Planfix interface.
Once you've connected all of the required APIs, you can move on to enabling [[Maps Integration | the integration with maps]] in the Planfix interface.
   
   
Note: If when you attempt to enter an address in a Location field you see a message with a red background saying you have reached the API limit, check that the payment account created in Step 2 is linked to the project created in Step 1.
 
'''Note:''' If when you attempt to enter an address in [[Location | a Location field]] you see a message with a red background saying you have reached the API limit, check that the payment account created in '''Step 2''' is linked to the project created in '''Step 1'''.
 
 
 
== Go To ==
*[[Maps Integration]]
*[[Integrations]]
*[[Feature Description]]

Latest revision as of 19:38, 1 March 2020

The Google Maps API is used to transform data containing addresses or location names from text to a data type designed for displaying objects on a map. This feature is used in the Planfix integration with maps.

To connect this integration, you will need to have a Google account (or you will need to create one).


Step 1. Connecting the Google Maps API

  • Follow this link to start the connection.


yWlX4U.png


  • Click Create:


3Z5wle.png


  • Give your new project a name and click Create:


jT4WMN.png


  • In the main menu (which you can open by clicking the "hamburger" button in the upper left-hand corner) select API and services / Credentials:


ZyaAku.png


  • Click Create credentials and select API Key:


0vKs1E.png


  • Copy the API key that appears and click CLOSE:


n23CbP.png


This key is required when connecting the Planfix maps integration.


Step 2. Setting up a payment account

To use the integration, you must connect a Google payment account to the project you created. If you don't have a payment account, you can create a new one by following the instructions below.

Important: At the time when this article was written, Google was offering new customers a $300 credit to spend on Google Cloud Platform products during their first year. All you need to do to get the bonus is create a new payment account and enter your credit card information. There will be no automatic payments made with your card; it's used so Google can make sure you're not a robot.


Steps for creating and connecting a payment account:

  • In the main menu (the "hamburger") select Billing:


IOIGXb.png


  • Click Manage billing accounts in the window that appears:


hSImqk.png


  • Click Add billing account:


YkeKIH.png


  • Select your country and agree to the terms of the free Google Cloud Platform trial period:


nZNGvV.png


  • On the next screen, fill out your contact information and credit card details.
  • Once you've saved this information, the payment account you created will be linked to the project you created earlier.


Step 3. Connecting libraries

To get the integration working correctly, you must connect the following APIs from the Google API library:

  • Maps JavaScript API
  • Geocoding API (for transforming addresses into coordinates)
  • Directions API (for building routes)
  • Places API (for suggestions when entering an address into a field)


To connect them, go to the API and services / Library section of the main menu (the "hamburger"):

19ClMG.png


  • Enter the name of the API you're looking for in the search bar (copy it from the list above):


BYvgds.png


  • Click the block for the API you want, and then click Enable:


y2uwnZ.png


  • Repeat these steps for each of the APIs in the list above.


Once you've connected all of the required APIs, you can move on to enabling the integration with maps in the Planfix interface.


Note: If when you attempt to enter an address in a Location field you see a message with a red background saying you have reached the API limit, check that the payment account created in Step 2 is linked to the project created in Step 1.


Go To