What does the GeoLocation API returns?

The GeoLocation API from RChilli provides location-based enrichment for both resume and job description (JD) data. It extracts, normalizes, and enriches location information to improve search accuracy, matching, and analytics.

Key Outputs of the GeoLocation API

When GeoLocation is enabled in parsing or enrichment processes for resumes or JDs, it returns the following data points:

1. City, State, and Country Identification

   • Extracts and standardizes location details from resumes and job descriptions.

   • Maps partial addresses (e.g., only city or state) to complete location information using RChilli’s global location database.

2. Formatted Address

   • Combines address components into a single structured format.

   • Example:

   "FormattedAddress": "402 Mulberry Lane, Houston, Texas, 77402, USA"
   

3. Country Code Information

   • Provides standardized country codes, including ISO Alpha-2, ISO Alpha-3, and UN numeric codes.

   • Example:

   {
     "CountryCode": {
       "IsoAlpha2": "US",
       "IsoAlpha3": "USA",
       "UNCode": "840"
     }
   }
   

4. Address Type and Confidence Score

   • Specifies the type of address (e.g., "Present" or "Permanent") and confidence score indicating extraction reliability.

API Setting for Auto-Completion

By passing "autocompletelocation": true in the API request’s apisetting node, the parser will:

• Auto-fill missing location details when possible by leveraging its location database.

• For example, if only a city is provided, it can infer and include the corresponding country.

Use Cases

• Resume Parsing: Extracts accurate candidate location details, even from incomplete or inconsistent addresses.

• JD Parsing: Normalizes job location data to enable precise geographic job-candidate matching.

• Search & Match: Supports localized matching by enriching geographic metadata for both resumes and JDs.

• Data Enrichment: Enhances existing databases with full geographic context for analytics and reporting.

How to Enable GeoLocation

GeoLocation enrichment is embedded within both the Resume Parser API and JD Parser API and can be controlled by:

• Using API settings such as formattedaddress, autocompletelocation, etc., in the apisetting node of your JSON request.

• Configuring your preferences in the RChilli My Account portal under API settings.

Security & Compliance

• GeoLocation data enrichment complies with RChilli’s stringent GDPR and ISO 27001 standards.

• The feature respects regional server configurations (US, EU, Singapore) to ensure data residency compliance.

Additional Resources

• For detailed dynamic API settings, refer to the JD Parser API Dynamic Settings Documentation and Resume Parser API Dynamic Settings Documentation.

If you need sample response schemas, example API requests, or help enabling GeoLocation for your specific use case, please contact support@rchilli.com.