-
Simplify Deployment:
- Streamline the Geo-Addressing SDK deployment process.
- Ensure an effortless deployment experience.
- Eliminate complexities for users when setting up the SDK.
-
Seamless Updates:
- Guarantee seamless updates for both data and software.
- Aim for zero downtime during updates, ensuring uninterrupted service.
-
Hassle-Free Deployments:
- Prioritize user-centric deployment experiences.
- Minimize potential deployment challenges and issues.
-
Ready-Made Solution:
- Develop a plug-and-play solution for immediate use.
- Minimize the need for extensive setup or configuration.
-
Language-Barrier Elimination:
- Expose all SDK functionalities as REST endpoints.
- Allow consumption of these endpoints by any type of client.
- Eliminate language barriers, enabling broader compatibility.
-
Microservices Deployment for Scalability:
- Create multiple microservices around the SDK.
- Move away from building a single monolithic application for each SDK functionality.
- Enhance scalability and flexibility by adopting a microservice architecture.
This solution is specifically for users who are looking for REST interface to interact with Geo Addressing SDK and Kubernetes based deployments.
Important
- Please consider these helm charts as recommendations only. They come with predefined configurations that may not be the best fit for your needs. Configurations can be tweaked based on the use case and requirements.
- These charts can be taken as a reference on how one can take advantage of the precisely-data ecosystem and build a number of services around the same piece of software, creating a collection of microservices that can scale on a need basis.
The core of the geo-addressing helm-chart-based solution relies on the Geo-Addressing SDK (GA-SDK). The robust
functionality of GA-SDK forms the backbone of our geo-addressing solution, empowering it to deliver accurate and
efficient
geo-addressing services while maintaining data integrity and usability.
The geo-addressing application is designed as a robust microservice-based architecture, utilizing a modular approach to provide highly optimized, scalable and precise addressing solutions.
Within this architecture, there are two key types of microservices:
- Regional Addressing Service: This microservice is an interface exposed to user consisting all the endpoints
pertaining the geo-addressing capabilities:
- Verify: performs address verification and standardization using the specified processing engine.
- Geocode: performs forward geocoding using input addresses and returning location data and other information.
- Reverse Geocode: performs reverse geocoding using input coordinates and returns address information that is the best match for that point.
- Autocomplete: yields matched addresses and place for the given input addresses.
- Lookup Service: returns geocoded candidates when given a unique key.
- Addressing Service (Country-Specific): These microservices are specialized for individual countries, allowing us to cater to unique addressing requirements and regulations in different regions. Each country-based addressing service is optimized for accuracy within its specific jurisdiction.
- Addressing Express: This microservice provides support for Geocoding without Country and new Address AutocompleteV2 service with enhanced quality & performance.
NOTE: We expect users to be familiar with concepts of Kubernetes and Helm in order to use the Geo Addressing Deployment via the Helm Charts.
Install Client tools required for installation. Follow the guides to get the steps for specific cloud platform: EKS | AKS | GKE
Create or use an existing K8s cluster. Follow the guides to get the steps for specific cloud platform: EKS | AKS | GKE
Download docker images and upload to your own container registry. Follow the guides to get the steps for specific cloud platform: EKS | AKS | GKE
Create or use an existing persistent volume for storing geo-addressing reference-data. Follow the guides to get the steps for specific cloud platform: EKS | AKS | GKE
Download and install the geo-addressing reference data in the persistent volume. Follow the guides to get the steps for specific cloud platform: EKS | AKS | GKE
Deploy the geo-addressing application using helm. Follow the guides to get the steps for specific cloud platform: EKS | AKS | GKE
- Understanding Geo Addressing Helm Chart
- Reference Data Structure
- Pushing Docker Images (AWS ECR)
- Pushing Docker Images (Microsoft ACR)
- Pushing Docker Images (Google Artifact Registry)
- Custom Data Import Job (Optional)
- Reference Data Installation Helm Chart
- Deploying Custom Regions
- Quickstart Guide For AWS EKS
- Quickstart Guide For Microsoft AKS
- Quickstart Guide For Google GKE
NOTE: As of now, geo-addressing helm chart is supported for AWS EKS, Microsoft AKS and Google's GKE cloud platforms.
Following is the helm version chart against geo-addressing PDX docker image version and GA-SDK version.
NOTE: The docker images pushed to the image repository should be tagged with the current helm chart version.
Refer Downloading Geo Addressing Docker Images for [EKS |AKS |GKE] for more information.