resolve-location
Resuelve una ubicación en texto libre a un geoId usable en search.
GET
/talent-scout/resolve-locationResuelve una ubicación en texto libre a un geoId usable en search. Las ubicaciones son ambiguas (una ciudad puede ser también nombre de provincia) — nunca adivines, seguí needsConfirmation.
Query params
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| city | string | Opcional | Nombre de ciudad |
| state | string | Opcional | Nombre de provincia/estado |
| country | string | Opcional | Nombre de país. Omitilo solo para ampliar la búsqueda a todos los países después de que una búsqueda con país no haya dado el resultado esperado. |
curl "https://api.reclee.com/v1/talent-scout/resolve-location?city=Buenos%20Aires&country=Argentina" \
-H "Authorization: Bearer rk_live_TU_API_KEY"Respuesta — 200
| Campo | Tipo | Descripción |
|---|---|---|
resolved | boolean | true solo si es inequívoco |
needsConfirmation | boolean | Si es true, mostrale candidates al usuario y esperá que elija — no lo hagas vos automáticamente |
geoId / displayName | string | Presentes solo si resolved: true |
candidates | array | [{ geoId, displayName, level }] — presente si needsConfirmation: true |
countryFallbackGeoId | string | geoId del país entero, por si querés usarlo como filtro amplio mientras el usuario decide |
Resuelto directo
{
"resolved": true,
"needsConfirmation": false,
"geoId": "90009870",
"displayName": "Greater Buenos Aires"
}Ambiguo — necesita que el usuario elija
{
"resolved": false,
"needsConfirmation": true,
"candidates": [
{ "geoId": "104738515", "displayName": "Córdoba, Argentina" },
{ "geoId": "90010330", "displayName": "Córdoba Province, Argentina" }
],
"countryFallbackGeoId": "100446943"
}