The document summarizes how to use FME to game a geocoding API by deploying a HERE Geocode API to AWS API Gateway and Lambda serverless architecture. It provides steps to register for a HERE developer key, deploy the open source geocoding API code to AWS, and connect FME to call the API via an HTTPCaller transformer and process the JSON response. The overall goal is to build a DIY geocoding solution using open source tools that provides geocoding capabilities without transaction costs for standard usage levels.

1. How to game a
Geocoding API
with FME
Steven Cyphers

2. PRESENTATION AGENDA
1
2
3
4
Background
HERE Geocode API is open-sourced
Deploy to AWS API Gateway
Freemium geocoding w/ FME

3. Inception

4. Some assembly required
Colleague shares a blog post
Some research on serverless geocoding
Register for developer key
DIY How-to https://youtu.be/j_j0ppq4VJE
Source https://github.com/heremaps/here-aws-sar

5. HERE Geocode API

6. here geocoding API
here developer material …‘here’
https://developer.here.com/
What is included: REST endpoint
Professional tier up to 1m transactions p/m (cost)
Standard tier up to 250k transactions p/m ($0)

7. Why build an API?
Geocoder Transformer?
UmmUmm

8. here geocoding API
Lambda serverless architecture
REST endpoint provided by API Gateway
Professional tier up to 1m transactions p/m (cost)
Standard tier up to 250k transactions p/m ($0)
Sometime you just want to DIY and see how it is built
no coins needed
UmmNo coins?

9. Open sourced on AWS

10. Open sourced?
For a walk through
Github repo https://github.com/heremaps/here-aws-sar
AWS Quickstart https://fwd.aws/pEKKB
Which launches this CloudFormation template

11. Lambda function
Github repo https://github.com/heremaps/here-aws-sar
AWS Quickstart https://fwd.aws/pEKKB
Which launches this CloudFormation template

12. API Gateway endpoint
Github repo https://github.com/heremaps/here-aws-sar
AWS Quickstart https://fwd.aws/pEKKB
Which launches this CloudFormation template

13. FMEocoding

14. HTTPCaller to Geocode API
https://geocodingDIY.execute-api.us-west-2.amazonaws.com/Stage/geocode/%7Bsearchtext%7D

15. Connect to API w/ FME
● HTTPCaller to Geocode API
● https://geocodingDIY.execute-api.us-west-2.amazonaws.com
/Stage/geocode/%7Bsearchtext%7D
● Plus your space separated address token like so
● 7Bsearchtext%7D@Value(_addr)
Lets try one 9639 137a St Surrey BC V3T 0M1 Canada

16. Some disassembly required
{"Response":{"MetaInfo":{"Timestamp":"2019-03-
23T15:46:23.720+0000"},"View":[{"_type":"SearchResultsViewType","ViewId":0,"Result":[{"Rel
evance":0.67,"MatchLevel":"houseNumber","MatchQuality":{"State":1.0,"City":1.0,"Street":[
1.0],"HouseNumber":1.0},"MatchType":"pointAddress","Location":{"LocationId":"NT_z2xOIQJ
G9XKeoMBxUPGZ8D_zIDM","LocationType":"point","DisplayPosition":{"Latitude":33.63169
, "Longitude":-117.74149},"NavigationPosition":[{"Latitude":33.63269,"Longitude":-
117.74128}],"MapView":{"TopLeft":{"Latitude":33.6328142,"Longitude":-
117.7428401},"BottomRight":{"Latitude":33.6305658,"Longitude":-
117.7401399}},"Address":{"Label":"320 Goddard, Irvine, CA 92618, United
States","Country":"USA","State":"CA","County":"Orange","City":"Irvine","District":"Irvine
Research
Center","Street":"Goddard","HouseNumber":"320","PostalCode":"92618","AdditionalData":[{"val
ue":"United
States","key":"CountryName"},{"value":"California","key":"StateName"},{"value":"Orange","key":
"CountyName"},{"value":"N","key":"PostalCodeType"}]}}}]}]}}
JSON Fragmenter

17. HTTPCaller to Geocode API
https://geocodingDIY.execute-api.us-west-2.amazonaws.com/Stage/geocode/%7Bsearchtext%7D

18. THANK YOU!
steven.cyphers@ghd.com / www.ghd.com/digital

20. Main point.

21. This is another great place for an FME dark mode
screenshot