Before you get started
- Send your 12-digit AWS account number to your Geocodio representative
- Per default, supplied AMI's are available in the us-east-1 region -- US East (N. Virginia). Be sure to let us know if you wish to use a different region.
Geocodio will supply you with:
- An AMI id
- A unique API key
Launch a geocodio instance via the AWS dashboard
- Go to the AWS EC2 dashboard
- Make sure to select the appropriate AWS region
- Click "AMIs" in the left navigation to see the list of available AMIs.
- In the list view, select the "Private images" filter and search for the supplied AMI id.
- Right click on the supplied image and select "Launch"
- In the launch wizard, select the following options:
Instance type: m5.4xlarge
Root volume: 320gb, GP2 SSD (Should already be pre-filled)
Security group: Make sure to open TCP port 80 and 443 for IP addresses or security groups that need access to the geocoding API.
- Wait for the instance to boot up and fully warm the cache (this can take up to 30 minutes).
- The API can now be accessed directly on the instance, using the supplied API key.
- Example: https://126.96.36.199/v1.3/geocode?q=20003&api_key=__YOUR_API_KEY__
If your license permits it, you can launch multiple instances using the instructions above.
The simplest way to orchestrate this is using Amazon ELB to distribute the load between your provisioned instances.