ABI

Материал из post-API.ru
Перейти к: навигация, поиск
 Array
 (
   [id] => ABI                                              // Массив-ответ типа ABI
   [api_ver] => 2.0                                         // Относится к v2 API
   [status] => ok                                           // Результат вернулся положительный
   [access] => active                                       // Ключ доступа - активный
   [access_status] => ok                                    // Доступ предоставлен успешно
   [executed_time] => 0.18843                               // Время исполнения скрипта 0,19 сек. 
   [source] => Array                                        // Исходные данные (для контроля правильности интерпретации скриптом)
       (
           [postalcode] => 141280
           [exclude] => 1
       )
   [content] => Array
       (
           [route] => Array                                  // Массив описывает маршрут адреса до города
               (
                   [region] => Array
                       (
                           [formalname] => Московская        // formalName - имя адаптированное для поиска (например, "ё" заменено на "е")
                           [shortname] => обл.               // Тип объекта - "область"
                           [offname] => Московская           // Официальное имя (например - Ёжиково)
                           [aolevel] => 1
                       )
                   [autonom] =>                              // Для автономной области
                   [area] =>                                 // Для названия района
                   [city] => Array                           // Название города (см. примечание 1)
                       (
                           [formalname] => Ивантеевка
                           [shortname] => г.
                           [offname] => Ивантеевка
                           [aolevel] => 4
                       )
               )
           [streets] => Array                                 // Массив содержит перечень улиц (см. примечание 2)
               (
                   [0] => Array
                       (
                           [id] => 665915
                           [formalname] => 3-я Пятилетка      // Название улицы, адаптированное для поиска
                           [shortname] => ул.                 // Тип улицы (переулок, проезд, и пр.)
                           [offname] => 3-я Пятилетка         // Официальное название "по документам"
                           [aolevel] => 7                     // Уровень объекта (см. примечание 3)
                           [houses] => Array                  // С каждой улицей связан массив домов (см. примечание 4)
                               (
                                   [0] => Array
                                       (
                                           [id] => 695522
                                           [housenum] => 1    // Номер дома - строка
                                           [strucnum] =>      // Номер строения
                                           [buildnum] =>      // Номер корпуса
                                           [formalname] => 1  // Формальное имя для визуализации
                                       )
                                   [1] => Array
                                       (
                                           [id] => 228602
                                           [housenum] => 2
                                           [strucnum] => 
                                           [buildnum] => 
                                           [formalname] => 2
                                       )
                                   [2] => Array
                                       (
                                           [id] => 814034
                                           [housenum] => 3
                                           [strucnum] => 
                                           [buildnum] => 
                                           [formalname] => 3
                                       )

...

                                   [96] => Array
                                       (
                                           [id] => 680035
                                           [housenum] => 99
                                           [strucnum] => 
                                           [buildnum] => 
                                           [formalname] => 99
                                       )
                               )
                       )
                   [1] => Array
                       (
                           [id] => 531789
                           [formalname] => Адмирала Жильцова
                           [shortname] => ул.
                           [offname] => Адмирала Жильцова
                           [aolevel] => 7
                           [houses] => Array
                               (
                                   [0] => Array
                                       (
                                           [id] => 64309
                                           [housenum] => 3
                                           [strucnum] => 
                                           [buildnum] => 
                                           [formalname] => 3
                                       )


...

                                   [0] => Array
                                       (
                                           [id] => 299669
                                           [housenum] => 1
                                           [strucnum] => 
                                           [buildnum] => 
                                           [formalname] => 1
                                       )
                               )
                       )
               )
       )
 )



Примечание 1: Иногда это поле может быть пустым. Обычно это происходит, когда под одним индексом скрываются несколько населенных пунктов.

Примечание 2: Помимо улиц, в ряде случаев в список могут включаться объекты, приравненные к улицам (см. примечание 3), а также небольшие населенные пункты (села и деревни), не имеющие собственных улиц.

Примечание 3: aolevel - это уровень объекта в федеральной кодификации. В результирующий массив streets попадают объекты типа 6 (малые населенные пункты, садовые кооперативы, санатории и дома отдыха), 7 (улицы, площади, бульвары, проспекты, проезды и пр.) и >50 (ГСК, СНТ и прочее). Последнюю категорию можно исключить с помощью ключа "&e=0" в запросе.

Примечание 4: Массив houses уже отсортирован для отображения в выпадающих списках по возрастанию нумерации. При этом сортировка идет только по первой цифре. То есть дома с рускими буквами в нумерации, или с номером строения будут отсортированы следующим образом: 1, 2, 2а, 2/7, 3, и пр.