Esta búsqueda resulta práctica porque no es necesario especificar si se busca una calle, un país, una casa, etc. Basta con una sola frase con las palabras en cualquier orden. Esta solicitud devuelve los resultados en el formato predeterminado: la ruta de la dirección formateada, las coordenadas y el nombre del mapa. Para obtener las coordenadas indicando la dirección en cualquier formato personalizado, utilice la siguiente solicitud:
Los parámetros obligatorios están marcados con un asterisco (*).
Nombre
Descripción
phrase*
Frase de búsqueda.
count*
Número de resultados que se devuelven.
indexFrom
Número de orden del primer resultado.
uid
ID del usuario actual. Obsoleto; utilice siempre gis_sid.
gis_sid*
ID único de la sesión del usuario.
search_provider*
Nombre del proveedor. Valores posibles de search_provider: google, sygic, yandex, here, trimble.
flags
Flags de búsqueda y formato (consulte a continuación).
searchFlags*
Flags de búsqueda adicionales (consulte a continuación).
lang
Idioma.
allow_irrelevant
1 - activo, permite resultados irrelevantes.
Flags de búsqueda
Copied!
Flag
Descripción
0x100
Incluir la ruta de la dirección en el resultado.
0x200
Incluir el nombre del mapa en el resultado.
0x400
Incluir las coordenadas del mapa en el resultado.
0x800
No crear JSON. Devolver los resultados como una lista de objetos.
Flags
Copied!
Flag
Descripción
0x0
Buscar país.
0x1
Buscar región.
0x2
Buscar ciudad.
0x3
Buscar calle.
0x4
Buscar casa.
0x100
Agregar al resultado campos con la ruta de la dirección formateada.
0x200
Agregar el nombre del mapa al resultado.
0x400
Agregar las coordenadas al resultado.
Respuesta
Copied!
Copied!
[
{
"items":[
{
"name":"<text>", /* nombre del elemento de búsqueda */"map":"<text>", /* nombre del mapa */"x":<double>, /* longitud */"y":<double>, /* latitud */"path":"<text>", /* parte de la ruta de la dirección, sin incluir la parte indicada en "name" */"formatted_path":"<text>"/* cadena de dirección formateada según los flags */
}
],
"country":"<text>", /* país */"region":"<text>", /* región */"city":"<text>", /* ciudad */"street":"<text>", /* calle */"house":"<text>", /* casa */"flags":<uint>, /* flags */"more":<uint> /* resultados adicionales: 0 - no, 1 - sí */
}
]
Flags que indican el nivel de detalle del resultado:
Flag
Descripción
0x0
País
0x1
Región
0x2
Ciudad
0x3
Calle
0x4
Casa
Códigos de error
Copied!
Código de error
Descripción
1
Sesión no válida.
4
Parámetros de entrada incorrectos.
6
Error desconocido.
7
Acceso denegado: proveedor de búsqueda desconocido.
Si nota un error en el texto, por favor resáltelo y presione Ctrl+Intro.