Routev4

Материал из post-API.ru
Перейти к: навигация, поиск
Модель с этим именем использовалась в предыдущих версиях API. См. route.

Описание

Структура route описывает цепочку адресов "область - район - город - населенный пункт". Используется:

 route:
   region:                              - Описывает область            
     aoguid: 0c5b2444-70a0-49......     - aoguid области
     formalname: Московская             - Название населенного пункта
     shortname: обл                     - Тип населенного пункта
     ufshortname: обл.                  - Тип населенног пункта в user-friendly формате
     aolevel: 1                         - Уровень населенного пункта в соответствии с ФИАС
     order: fs                          - Порядок: shortname/formalname или formalname/shortname
     formatname: Московская обл.        - Отформатированное user-friendly название области
     lat: '55.755773'                   - Широта населенного пункта
     long: '37.617761'                  - Долгота населенного пункта
     geo: 
       lb_lat: '56.01074'               - Широта левого нижнего угла квадрата, описывающего область
       lb_long: '37.964969'             - Долгота левого нижнего угла квадрата, описывающего область
       ru_lat: '55.490667'              - Широта правого верхнего угла квадрата, описывающего область
       ru_long: '37.182743'             - Широта правого верхнего угла квадрата, описывающего область
     yandex: http://maps.yandex.ru/?ll=37.731982,55.662862&z=12&pt=37.731982,55.662862,pm2dom
     google: http://maps.google.com/maps?q=loc:55.662862,37.731982&t=m
   area:                                - Описание района
     aoguid: a87ff831-986b-44a7-8405-00fc699de4ce
     formalname: Мытищинский
     shortname: р-н
     ufshortname: р-н
     aolevel: 3
     order: fs
     formatname: Мытищинский р-н
     lat: '56.017176'
     long: '37.647001'
     geo:
       lb_lat: '56.165338'
       lb_long: '37.857324'
       ru_lat: '55.868445'
       ru_long: '37.436679'
     yandex: http://maps.yandex.ru/?ll=37.647001,56.017176&z=12&pt=37.647001,56.017176,pm2dom
     google: http://maps.google.com/maps?q=loc:56.017176,37.647001&t=m
   city:                                - Описание города 
     aoguid: 5f290be7-14ff-4ccd-8bc8-2871a9ca9d5f
     formalname: Мытищи
     shortname: г
     ufshortname: г.
     aolevel: 4
     order: sf
     formatname: г. Мытищи
     lat: '55.910528'
     long: '37.736339'
     geo:
       lb_lat: '55.961546'
       lb_long: '37.813172'
       ru_lat: '55.878152'
       ru_long: '37.66221'
     yandex: http://maps.yandex.ru/?ll=37.736339,55.910528&z=12&pt=37.736339,55.910528,pm2dom
     google: http://maps.google.com/maps?q=loc:55.910528,37.736339&t=m
   nas:                                 - Описание населенного пункта в составе города
     aoguid: 
     formalname: 
     shortname: 
     ufshortname: 
     aolevel: 0
     order: 
     formatname: 
     lat: 0
     long: 0
     geo:
       lb_lat: 0
       lb_long: 0
       ru_lat: 0
       ru_long: 0
   formatname: г. Мытищи / Мытищинский р-н / Московская обл.  - User-friendly название всех объектов
   mkad                                                       - Структура mkad
   cityid: 5f290be7-14ff-4ccd-8bc8-2871a9ca9d5f               - Идентификатор города в методе CBPv4_(метод)

Особенности

  • Поле city заполнено всегда. Для трех городов федерального значения (Москва, Санкт-Петербург, Байконур) будет вырожденная ситуация, когда заполняется только блок 'city'. Во всех остальных случаях, при заполненном блоке 'city' обязательно заполнен блок 'region'
  • Значения 'yandex' и 'google' появляются только в методе OBG, при установленных соответствующих ключах
  • Поверку наличия элемента определенного уровня рекомендуется проводить через проверку aolevel. Если $route['nas']['aolevel'] == 0, то элемент nas отсутствует.


История

  • 05.10.2013 - Структура определена для методов версии 4.0