|
| 1 | + |
| 2 | + |
| 3 | +# API-Builder Google-Maps Connector |
| 4 | + |
| 5 | +Integrate Google-Maps services into your [API-Builder flow][1] using this connector. Google-Maps Services are a number of APIs provided by Google and this connector helps you to integrate with them easily. |
| 6 | + |
| 7 | +## Configuration |
| 8 | + |
| 9 | +After installation and restarting your API-Builder project you get the following new flow-nodes: |
| 10 | +![Node][img1] |
| 11 | +Before you can make use it in your flow you have to configure your Google API-Key, which must be activated for the correct Google-APIs. Access the [Google Console][6] and learn more [here][7]. |
| 12 | + |
| 13 | +During installation a new config file has been automatically created which must be completed with your Google-API-Key. You can do that directly from within the API-Builder UI: |
| 14 | +![Config][img3] |
| 15 | +We recommend to setup your configuration in a [environmentalized][4] way keeping [sensitive information][5] away from the source-code repository. |
| 16 | + |
| 17 | +## Google-Maps services |
| 18 | +This Connector is based on the https://github.com/googlemaps/google-maps-services-js project. It's a good starting point to understand the APIs and their parameters reading the following documentation: |
| 19 | + |
| 20 | +- [Directions API](https://developers.google.com/maps/documentation/directions/start) |
| 21 | +- [Distance Matrix API](https://developers.google.com/maps/documentation/distance-matrix/start) |
| 22 | +- [Elevation API](https://developers.google.com/maps/documentation/elevation/) |
| 23 | +- [Geocoding API](https://developers.google.com/maps/documentation/geocoding/) |
| 24 | +- [Reverse Geocoding API](https://developers.google.com/maps/documentation/geocoding/start#reverse) |
| 25 | +- [Places API](https://developers.google.com/places/web-service/) |
| 26 | + |
| 27 | +## Tests |
| 28 | +The connector is shipped with a number of Unit- and Integration tests. To execute the test-suite locally, please setup an environment variable: |
| 29 | +`GOOGLE_API_KEY=AIzaSyC...........Ws` |
| 30 | +And run the following command: |
| 31 | +`npm test` |
| 32 | +The tests are also automatically executed on every commit to this project. |
| 33 | + |
| 34 | +## Compatibility |
| 35 | +Tested with Google-Maps Q1/2020 |
| 36 | +Requires API-Builder Independence or higher |
| 37 | + |
| 38 | +## Changelog |
| 39 | +- 1.0.0 - 21.02.2020 |
| 40 | + - Initial version |
| 41 | + |
| 42 | +## Limitations/Caveats |
| 43 | +The follow APIs are not yet supported: |
| 44 | +- Place Photos |
| 45 | +- Place Autocomplete |
| 46 | +- Query Autocomplete |
| 47 | +- Roads API |
| 48 | +- Time Zone API |
| 49 | + |
| 50 | +If you require on the of the unsupported APIs don't hestitate to create an [issue][3] |
| 51 | + |
| 52 | +## Contributing |
| 53 | + |
| 54 | +Please read [Contributing.md](https://github.com/Axway-API-Management-Plus/Common/blob/master/Contributing.md) for details on our code of conduct, and the process for submitting pull requests to us. |
| 55 | + |
| 56 | +## Team |
| 57 | + |
| 58 | +![alt text][Axwaylogo] Axway Team |
| 59 | + |
| 60 | +[Axwaylogo]: https://github.com/Axway-API-Management/Common/blob/master/img/AxwayLogoSmall.png "Axway logo" |
| 61 | + |
| 62 | +[1]: https://docs.axway.com/bundle/API_Builder_4x_allOS_en/page/api_builder_flows.html |
| 63 | +[2]: https://docs.axway.com/bundle/API_Builder_4x_allOS_en/page/api_builder_getting_started_guide.html |
| 64 | +[3]: https://github.com/Axway-API-Builder-Ext/api-builder-extras/issues |
| 65 | +[4]: https://docs.axway.com/bundle/API_Builder_4x_allOS_en/page/environmentalization.html |
| 66 | +[5]: https://docs.axway.com/bundle/API_Builder_4x_allOS_en/page/project_configuration.html#ProjectConfiguration-Configurationfiles |
| 67 | +[6]: https://console.cloud.google.com |
| 68 | +[7]: https://developers.google.com/maps/documentation/javascript/get-api-key |
| 69 | + |
| 70 | +[img1]: imgs/google-maps-flownode.png |
| 71 | +[img2]: imgs/google-maps-directions.png |
| 72 | +[img3]: imgs/google-maps-config.png |
0 commit comments