GET /v3/ciudades/bestmatch

Búsqueda de la ciudad que mejor encaja según los parámetros suministrados. Este es tu mejor amigo para evitar mapeo de estados/provincia/región y ciudad, entre tus valores y los registrados en Autocosmos, antes enviarnos una dirección.

Request

Query parameters

Name Type Constraints Descripción
state string Required
 Valor de búsqueda para provincia/estado/región; soportado id, api-url, api-url-path, nombre, iso.
city string Required
 Valor de búsqueda para ciudad; soportado id, api-url, api-url-path, nombre completo, parte del nombre.

Responses

HTTP-StatusCode 200

OK

Ciudad when Accept: application/json application/vnd.autocosmos.entry+json text/json 
{
  "Nombre": "Torino",
  "Region": "Torino",
  "_links": {
    "rel1": {
      "href": "/v3/ciudades/somevalue"
    }
  }
}
CiudadRef when Accept: application/vnd.autocosmos.ref+json 
{
  "href": "/v3/ciudades/somevalue",
  "title": "Maranello (Modena)"
}

HTTP-StatusCode 400

ValidationProblemDetails Content-Type: application/problem+json 
{
  "Errors": {
    "_": [
      "entry problem1",
      "entry problem2"
    ],
    "property1": [
      "problem 1"
    ]
  },
  "Type": "https://httpstatuses.com/400",
  "Title": "Validación de información esperada fallida",
  "Status": 400,
  "Detail": "Alguna información contiene valores no validos.",
  "Instance": "/v3/somewhere",
  "Extensions": {}
}