Geographical Search
This feature is used to find a candidate near you through geographical search in simple and advance search methods.
The search is done using Geocodes/City, State, Country or a distance range. You can select different parameters for measuring the distance range like KM and mile.
The geoSearch is an optional parameter (query) that can be passed in the API request of Simple Search, Boolean Search, Free Text Search, Match, Match with ID, and Match with Multiple Sub-User Ids.
Once geoSearch is passed in the request parameter of above API's, it will return the
resume/JD that fulfills the geoSearch query.
Note:
- By dafault, when geoSearch is passed in the API request, the score for the returned resume/JD is reduced by 50%, and the remaining 50% score is allocated to the geoSearch query. To know more, see the sample Simple Search query below with and without geoSearch.
- When the geoSearchScore parameter is included in the API request, the
score assigned to the geoSearch query is determined by the value specified
in the geoSearchScore parameter. This allows you to dynamically
change the score for the geoSearch query using geoSearchScore
parameter. For example, if
"geoSearchScore": 20is passed in the API request, then 20% of the score is assigned to the geoSearch query, and the remaining 80% is returned for the resume/JD.
Simple Search query without geoSearch - Request
{
"index": {
"indexType": "Resume",
"indexKey": "Use your userkey"
},
"query": {
"keyword": "Developer Java Mysql"
},
"showCustomValue": true,
"pageSize": 20,
"pageStart": 0,
"explainScore": true,
"explainScoreType": "json"
}Simple Search query without geoSearch - Response
Note: Note the score for the document id: 5207077866431426
is 24 (when geoSearch is not passed).
{
"count": 18,
"pageStart": 0,
"pageSize": 20,
"records": [
{
"id": "5178399156197622",
"score": 30.0,
"CurrentEmployer": "Ai shala",
"TotalExperienceInYear": 3.7,
"CurrentJobProfile": "Ml Research Intern",
"FullName": "Nikhil Bhutani",
"SubUserId": "5"
},
{
"id": "5256476031733922",
"score": 30.0,
"CurrentEmployer": "Ai shala",
"TotalExperienceInYear": 3.7,
"CurrentJobProfile": "Ml Research Intern",
"FullName": "Nikhil Bhutani",
"SubUserId": "10"
},
{
"id": "5260890115334121",
"score": 30.0,
"CurrentEmployer": "Bsol Systems",
"TotalExperienceInYear": 8.11,
"CurrentJobProfile": "Senior Quality Analyst",
"FullName": "Archana Nagekar",
"SubUserId": "6"
},
{
"id": "5126034053612582",
"score": 30.0,
"CurrentEmployer": "Rchilli",
"TotalExperienceInYear": 6.8,
"CurrentJobProfile": "Software Engineer Automation Tester",
"FullName": "Sanjoli Mittal",
"SubUserId": "6"
},
{
"id": "5186526873654101",
"score": 30.0,
"CurrentEmployer": "Bsol Systems",
"TotalExperienceInYear": 8.11,
"CurrentJobProfile": "Senior Quality Analyst",
"FullName": "Archana Nagekar",
"SubUserId": "3"
},
{
"id": "5207077866431426",
"score": 24.0,
"State": "Himachal Pradesh",
"FullName": "Amit Rana",
"Country": "India",
"SubUserId": "19",
"City": "Una"
},
{
"id": "5101080517624117",
"score": 24.0,
"CurrentEmployer": "Sigmoid Analytics",
"TotalExperienceInYear": 8.5,
"CurrentJobProfile": "Software Developer",
"State": "Karnataka",
"FullName": "Md Amir",
"Country": "India",
"SubUserId": "4",
"City": "Bangalore"
},
{
"id": "5157265537097379",
"score": 24.0,
"TotalExperienceInYear": 9.6,
"CurrentJobProfile": "Developer",
"State": "Madhya Pradesh",
"FullName": "Nitesh Shrivastava",
"Country": "India",
"SubUserId": "6",
"City": "Jabalpur"
},
{
"id": "5247956883963974",
"score": 24.0,
"CurrentEmployer": "Sigmoid Analytics",
"TotalExperienceInYear": 8.5,
"CurrentJobProfile": "Software Developer",
"State": "Karnataka",
"FullName": "Md Amir",
"Country": "India",
"SubUserId": "6",
"City": "Bangalore"
},
{
"id": "5203902706787367",
"score": 24.0,
"CurrentEmployer": "De La Rue",
"TotalExperienceInYear": 25.1,
"CurrentJobProfile": "Sr. Software Developer/lead Software Developer",
"State": "Karnataka",
"FullName": "Gutta Sravanthi",
"Country": "India",
"SubUserId": "6",
"City": "Bangalore"
},
{
"id": "5120573970373115",
"score": 24.0,
"CurrentEmployer": "Tech mahindra",
"TotalExperienceInYear": 5.1,
"CurrentJobProfile": "Senior Software Engineer",
"FullName": "Jitendra Gupta",
"SubUserId": "6"
},
{
"id": "5276794062214261",
"score": 24.0,
"CurrentEmployer": "Ge Healthcare",
"TotalExperienceInYear": 14.6,
"CurrentJobProfile": "Senior Software Engineer",
"State": "Rajasthan",
"FullName": "Nitin Gupta Kumar",
"Country": "India",
"SubUserId": "6",
"City": "Jaipur"
},
{
"id": "5131909428566825",
"score": 24.0,
"CurrentEmployer": "D K Infosolutions",
"TotalExperienceInYear": 19.11,
"CurrentJobProfile": "Senior Software Engineer",
"State": "New delhi",
"FullName": "Amrit Suman",
"Country": "India",
"SubUserId": "6",
"City": "New Delhi"
},
{
"id": "5281084636234093",
"score": 24.0,
"CurrentEmployer": "Bluebird",
"TotalExperienceInYear": 5.7,
"CurrentJobProfile": "Aws Engineer",
"FullName": "Annie Desantis A",
"SubUserId": "5"
},
{
"id": "5200912605198873",
"score": 24.0,
"CurrentEmployer": "De La Rue",
"TotalExperienceInYear": 25.1,
"CurrentJobProfile": "Sr. Software Developer/lead Software Developer",
"State": "Karnataka",
"FullName": "Gutta Sravanthi",
"Country": "India",
"SubUserId": "3",
"City": "Bangalore"
},
{
"id": "5191875320673067",
"score": 24.0,
"CurrentEmployer": "Tech mahindra",
"TotalExperienceInYear": 5.1,
"CurrentJobProfile": "Senior Software Engineer",
"FullName": "Jitendra Gupta",
"SubUserId": "3"
},
{
"id": "5153273025043804",
"score": 24.0,
"CurrentEmployer": "Ge Healthcare",
"TotalExperienceInYear": 14.6,
"CurrentJobProfile": "Senior Software Engineer",
"State": "Rajasthan",
"FullName": "Nitin Gupta Kumar",
"Country": "India",
"SubUserId": "3",
"City": "Jaipur"
},
{
"id": "5174684486827000",
"score": 24.0,
"CurrentEmployer": "D K Infosolutions",
"TotalExperienceInYear": 19.11,
"CurrentJobProfile": "Senior Software Engineer",
"State": "New delhi",
"FullName": "Amrit Suman",
"Country": "India",
"SubUserId": "3",
"City": "New Delhi"
}
],
"explainScore": [
{
"id": "5200912605198873",
"SubUserId": "3",
"explaination": {
"score": "24.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 24.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 24.0,
"maxScore": 30.0,
"entity": "SkillWithoutExp",
"value": "mysql"
}
]
}
}
},
{
"id": "5247956883963974",
"SubUserId": "6",
"explaination": {
"score": "24.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 24.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 24.0,
"maxScore": 30.0,
"entity": "SkillWithoutExp",
"value": "mysql"
}
]
}
}
},
{
"id": "5157265537097379",
"SubUserId": "6",
"explaination": {
"score": "24.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 24.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 24.0,
"maxScore": 30.0,
"entity": "SkillAlias",
"value": "mysql"
}
]
}
}
},
{
"id": "5120573970373115",
"SubUserId": "6",
"explaination": {
"score": "24.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 24.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 24.0,
"maxScore": 30.0,
"entity": "SkillWithoutExp",
"value": "mysql"
}
]
}
}
},
{
"id": "5256476031733922",
"SubUserId": "10",
"explaination": {
"score": "30.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 30.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 30.0,
"maxScore": 30.0,
"entity": "SkillHaveExp",
"value": "mysql"
}
]
}
}
},
{
"id": "5276794062214261",
"SubUserId": "6",
"explaination": {
"score": "24.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 24.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 24.0,
"maxScore": 30.0,
"entity": "SkillWithoutExp",
"value": "mysql"
}
]
}
}
},
{
"id": "5203902706787367",
"SubUserId": "6",
"explaination": {
"score": "24.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 24.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 24.0,
"maxScore": 30.0,
"entity": "SkillWithoutExp",
"value": "mysql"
}
]
}
}
},
{
"id": "5131909428566825",
"SubUserId": "6",
"explaination": {
"score": "24.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 24.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 24.0,
"maxScore": 30.0,
"entity": "SkillWithoutExp",
"value": "mysql"
}
]
}
}
},
{
"id": "5260890115334121",
"SubUserId": "6",
"explaination": {
"score": "30.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 30.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 30.0,
"maxScore": 30.0,
"entity": "SkillHaveExp",
"value": "mysql"
}
]
}
}
},
{
"id": "5186526873654101",
"SubUserId": "3",
"explaination": {
"score": "30.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 30.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 30.0,
"maxScore": 30.0,
"entity": "SkillHaveExp",
"value": "mysql"
}
]
}
}
},
{
"id": "5207077866431426",
"SubUserId": "19",
"explaination": {
"score": "24.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 24.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 24.0,
"maxScore": 30.0,
"entity": "SkillWithoutExp",
"value": "mysql"
}
]
}
}
},
{
"id": "5101080517624117",
"SubUserId": "4",
"explaination": {
"score": "24.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 24.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 24.0,
"maxScore": 30.0,
"entity": "SkillWithoutExp",
"value": "mysql"
}
]
}
}
},
{
"id": "5126034053612582",
"SubUserId": "6",
"explaination": {
"score": "30.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 30.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 30.0,
"maxScore": 30.0,
"entity": "SkillHaveExp",
"value": "mysql"
}
]
}
}
},
{
"id": "5153273025043804",
"SubUserId": "3",
"explaination": {
"score": "24.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 24.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 24.0,
"maxScore": 30.0,
"entity": "SkillWithoutExp",
"value": "mysql"
}
]
}
}
},
{
"id": "5281084636234093",
"SubUserId": "5",
"explaination": {
"score": "24.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 24.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 24.0,
"maxScore": 30.0,
"entity": "SkillAlias",
"value": "mysql"
}
]
}
}
},
{
"id": "5174684486827000",
"SubUserId": "3",
"explaination": {
"score": "24.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 24.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 24.0,
"maxScore": 30.0,
"entity": "SkillWithoutExp",
"value": "mysql"
}
]
}
}
},
{
"id": "5191875320673067",
"SubUserId": "3",
"explaination": {
"score": "24.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 24.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 24.0,
"maxScore": 30.0,
"entity": "SkillWithoutExp",
"value": "mysql"
}
]
}
}
},
{
"id": "5178399156197622",
"SubUserId": "5",
"explaination": {
"score": "30.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 30.0,
"maxScore": 100.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 70.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 30.0,
"maxScore": 30.0,
"entity": "SkillHaveExp",
"value": "mysql"
}
]
}
}
}
]
}Simple Search query with geoSearch - Request
{
"index": {
"indexType": "Resume",
"indexKey": "Use your userkey"
},
"query": {
"keyword": "Developer Java Mysql"
},
"geoSearch": {
"city": "Una",
"state": "Himachal Pradesh",
"country": "India"
},
"showCustomValue": true,
"pageSize": 20,
"pageStart": 0,
"explainScore": true,
"explainScoreType": "json"
}Simple Search query with geoSearch - Response
Note: The score for the document id: 5207077866431426 is 62
(when geoSearch is passed in the below request). The score for this id in the above
request is 24 (when geoSearch is not passed in the request). The increase
in the score is calculated as follows:
- geoSearch score = 50
- Document id score = 12 (reduced by 50%, Document id score was 24 in above request)
- Total Score = 50+12 = 62.
{
"count": 1,
"pageStart": 0,
"pageSize": 20,
"records": [
{
"id": "5207077866431426",
"score": 62.0,
"State": "Himachal Pradesh",
"FullName": "Amit Rana",
"Country": "India",
"SubUserId": "19",
"City": "Una"
}
],
"explainScore": [
{
"id": "5207077866431426",
"SubUserId": "19",
"explaination": {
"score": "62.00",
"maxScore": 100.0,
"SimpleSearch": {
"score": 12.0,
"maxScore": 50.0,
"detailScore": [
{
"score": 0.0,
"maxScore": 35.0,
"entity": "JobProfile",
"value": "Developer Java"
},
{
"score": 12.0,
"maxScore": 15.0,
"entity": "SkillWithoutExp",
"value": "mysql"
}
]
},
"geoSearch": {
"score": 50.0,
"maxScore": 50.0,
"detailScore": [
{
"Location": "Una,Himachal Pradesh,India",
"GeoCode": "76.26914000,31.46493000",
"Radius": "50.0"
},
{
"Location": "Una,Himachal Pradesh,India",
"GeoCode": "76.25000000,31.58333000",
"Radius": "50.0"
},
{
"Location": "Una,Himachal Pradesh,India",
"GeoCode": "76.19283000,31.58369000",
"Radius": "50.0"
}
]
}
}
}
]
}API request Parameters
Request parameters for geoSearch are described below:
| Name | Type | Description | Remarks |
|---|---|---|---|
| Option 1 | |||
| city | String | Name of city | Required |
| state | String | Name of state related to city | Optional |
| country | String | Name of Country related to state | Optional |
| radius | Integer | Default value is 50 | Optional |
| distanceUnit | String | Default is KM (Kilometer). Possible values are KM and mile | Optional |
| Option 2 | |||
| longitude | String | Name of city | Required |
| latitude | String | Name of state related to city | Required |
| radius | Integer | Default value is 50 | Optional |
| distanceUnit | String | Default is KM (Kilometer). Possible values are KM and mile | Optional |
JSON request with geoSearch parameter (option 1)
"geoSearch": {
"city": "Pune",
"state": "Maharashtra ",
"country": "India",
"radius": 50,
"distanceUnit": "mile"
}JSON request with geoSearch parameter (option 2)
"geoSearch": {
"longitude": "70.255",
"latitude": "-52.02",
"radius": 50,
"distanceUnit": "mile"
}Geographical Search in My Account
The following steps describe on how to do Geographical Search in the My Account.
- Enter your Email and Password to log in to the RChilli My
Account partner portal. You can also Sign Up to register a new
account or log in using Office 365 or Google accounts as
necessary.Note: Contact support@rchilli.com for My Account portal access, subscription plans, pricing, and for any further support.
- On the Integration (Demo) tab, click Search and Match 3.0 on
the navigation panel, and select Resume Search or JD Search
from the drop-down.
- For the Geographical Search, fill the Location field and select the
distance range from the Distance drop-down. The search result for
this Geographical Search query will return the resume that fulfill the
Location and Distance criteria.
- For JD Search, Geographical Search query will return the JD that
fulfill the Location and Distance criteria
Error codes
| Error Code | Error Message |
|---|---|
| 2132 | GeoSearch score must be 0 to 100 |
| 2133 | GeoSearch score must be a number type |