Geocodificar una dirección
Geocoder.geocode
Convierte una dirección estructurada con el campo city obligatorio en coordenadas y detalles de la dirección coincidente.
Parámetros del body
| Cuerpo de la solicitud | Tipo | Descripción |
|---|---|---|
address | object REQUERIDO | Proporcione un objeto de dirección con el campo city obligatorio. Los demás campos son opcionales; incluya suficientes datos para encontrar una coincidencia. |
country | string | Código de país opcional. Si falta o es null, se usa PL; un valor vacío permanece vacío. Use PL en mayúsculas para direcciones polacas. La geocodificación internacional requiere acceso adecuado. |
province | string | Nombre de provincia opcional; no se completa automáticamente. |
district | string | Opcional. Ausente o null toma una cadena vacía. |
community | string | Opcional. Ausente o null toma una cadena vacía. |
city | string REQUERIDO | El nombre de ciudad city es obligatorio en cada dirección, también para PL. |
quarter | string | Opcional. Ausente o null toma una cadena vacía. |
pcode | string | Opcional. Ausente o null toma una cadena vacía. |
street | string | Opcional. Ausente o null toma una cadena vacía. |
house | string | Opcional. Ausente o null toma una cadena vacía. |
maxResult | integer | Para direcciones polacas, hasta 1–3 coincidencias por dirección (1 por defecto). Los valores fuera del rango se limitan a 1–3. Establezca maxResult en cada dirección; maxResults no establece este límite. |
Solicitud de ejemplo
{
"address": {
"country": "PL",
"city": "Warszawa",
"street": "Domaniewska",
"house": "37"
}
}Respuesta de ejemplo
{
"result": [
{
"quality": 9,
"x": 21.0071318,
"y": 52.18284,
"country": "PL",
"province": "mazowieckie",
"district": "Warszawa",
"community": "Warszawa",
"city": "Warszawa",
"quarter": "Mokotów",
"pcode": "02-672",
"street": "Domaniewska",
"house": "37",
"resultRadius": 0,
"flat": ""
}
]
}El ejemplo muestra una selección de campos de respuesta. Las coordenadas y los datos postales reales dependen de la entrada y de los datos cartográficos actuales; también pueden aparecer campos ampliados sujetos a permisos.
campos result
| campos result | Tipo | Descripción |
|---|---|---|
quality | integer | Geocoding quality score. |
x | double | Longitude (WGS84). |
y | double | Latitude (WGS84). |
country | string | Country code. |
province | string | Province. |
district | string | District (powiat). |
community | string | Community (gmina). |
city | string | City. |
quarter | string | Quarter. |
pcode | string | Postal code (PL only). |
street | string | Street. |
house | string | House number. |
addressType | integer EXTENDIDO | Building type. Extended. |
peoplesForAddress | integer EXTENDIDO | Residents at address. Extended. |
flatsForAddress | integer EXTENDIDO | Flats at address. Extended. |
buildingsForAddress | integer EXTENDIDO | Buildings at address. Extended. |
pcodeExtraInfo | object[] EXTENDIDO | Extra postal-code info. Extended. |
resultRadius | number | Result envelope radius (m). -1 if unknown. |
mapLink | string | Link to map result. |