Как получать сущности из гео-базы для дальнейшего таргетинга

Как получить разные сущности из геобазы

В геобазе мы используем ElasticSearch, из-за чего становится доступным использовать полно-текстовый поиск.

За базовый запрос можно использовать то, что было приведено выше.

У каждой сущности есть свои properties, они имеют следующее определение:

• id – айди, который используется при создании опроса в таргетинге

• type – подразумевает тип сущности. Например:

  • federal_district - федеральный округ, например "ЦФО"

  • subdivision - область или город федерального значения (далее - ГФЗ). Например, ГФЗ "Москва" будет включать в себя "Троицк", а "город Москва" — нет. Разница на карте — "ГФЗ Москва" и "город Москва"

  • city - город, например "Калининград" или "Ярославль"

  • city_district - район города, есть не везде и не всегда, но когда есть - работает точно.

  • country - страна

  • division - административное деление, например "городской округ Волгодонск" или "Каменский район"

  • economic_district - экономический округ

• kind – тип города, есть не везде

  • hamlet - деревня в размере 100-200 человек

  • village - деревня побольше

  • town - небольшой город, среднее между village и city, обычно до 100к жителей

  • city - город

• population - размер населения, есть у всех городов, но нету у town ниже

• official_status - оффициальный статус, например "ru:внутригородская территория города федерального значения"

Пример реального запроса

playground

Во всех следующих запросах мы будем использовать один и тот же запрос, меняться будут только переменные.

import fetch from 'node-fetch';

function searchPlaces(search: string, size: number = 1) {
  return fetch('https://hub.youthink.io/graphql', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Accept: 'application/json',
    },
    body: JSON.stringify({
      query: `
  query SearchPlaces($search: String!, $size: Float = 300) {
    searchPlaces(query: $search, size: $size) {
      id
			type
      name_ru
      name_en
      population
    }
  }
  `,
      variables: { size, search },
    }),
  }).then(response => response.json()).then(json => json.data);
}

Получить города миллионики (playground)

searchPlaces('(population:>1000000 AND type:"city")', 5).then(console.log);

Этот запрос возвращает сущности, у которых население больше 1 000 000 (миллиона) и которые являются городами в порядке населенности. Возвращает 5 записей, но можно больше.

Из запроса понятно, что в начале указываются значения в скобках — это фильтры по значениям выше. После скобок можно указать текст — по нему идет поиск.

andreyvasilev@MacBook-Pro-Andrey src % npx ts-node fetchExample.ts
{
  searchPlaces: [
    {
      id: 44947,
      name_ru: 'Москва',
      name_en: 'Moscow',
      population: 12615279
    },
    {
      id: 45345,
      name_ru: 'Санкт-Петербург',
      name_en: 'Saint Petersburg',
      population: 5383890
    },
    {
      id: 45348,
      name_ru: 'Новосибирск',
      name_en: 'Novosibirsk',
      population: 1618039
    },
    {
      id: 44203,
      name_ru: 'Екатеринбург',
      name_en: 'Yekaterinburg',
      population: 1483119
    },
    {
      id: 45156,
      name_ru: 'Нижний Новгород',
      name_en: 'Nizhny Novgorod',
      population: 1253511
    }
  ]
}

Получить области.

searchPlaces('(type:"subdivision")', 5).then(console.log);

Возвращает:

{
  searchPlaces: [
    {
      id: 26,
      name_ru: 'Москва',
      name_en: 'Moscow',
      population: 12615279
    },
    {
      id: 67,
      name_ru: 'Московская область',
      name_en: 'Moscow Oblast',
      population: 7599647
    },
    {
      id: 99,
      name_ru: 'Краснодарский край',
      name_en: 'Krasnodar Krai',
      population: 5648235
    },
    {
      id: 23,
      name_ru: 'Санкт-Петербург',
      name_en: 'Saint Petersburg',
      population: 5383890
    },
    {
      id: 97,
      name_ru: 'Свердловская область',
      name_en: 'Sverdlovsk Oblast',
      population: 4315699
    }
  ]
}

По такому же принципу можно получить федеральные округа, если использовать вместо subdivision — federal_district.

Получить районы Москвы.

searchPlaces('"Москва" округ', 5).then(console.log);

В данном случае, слово "Москва" взято в кавычки для точного вхождения.

{
  searchPlaces: [
    {
      id: 3579,
      type: 'division',
      name_ru: 'Южный административный округ',
      name_en: 'Southern Administrative Okrug',
      population: 1793456
    },
    {
      id: 3510,
      type: 'division',
      name_ru: 'Восточный административный округ',
      name_en: 'Eastern Administrative Okrug',
      population: 1523420
    },
    {
      id: 4761,
      type: 'division',
      name_ru: 'Западный административный округ',
      name_en: 'Western Administrative Okrug',
      population: 1392993
    },
    {
      id: 4899,
      type: 'division',
      name_ru: 'Северный административный округ',
      name_en: 'Northern Administrative Okrug',
      population: 1185416
    },
    {
      id: 2566,
      type: 'division',
      name_ru: 'Центральный административный округ',
      name_en: 'Central Administrative Okrug',
      population: 782048
    }
  ]
}

Районы Саратова.

searchPlaces('"Саратов" район', 5).then(console.log);

Города внутри Санкт-Петербурга:

searchPlaces('(type:"city") "Санкт-Петербург"', 10).then(console.log);

В этом случае, в контексте "Санкт-Петербург" имеется название ГФЗ

{
  searchPlaces: [
    {
      id: 45345,
      type: 'city',
      name_ru: 'Санкт-Петербург',
      name_en: 'Saint Petersburg',
      population: 5383890
    },
    {
      id: 42915,
      type: 'city',
      name_ru: 'Колпино',
      name_en: 'Kolpino',
      population: 147965
    },
    {
      id: 42905,
      type: 'city',
      name_ru: 'Пушкин',
      name_en: 'Pushkin',
      population: 111205
    },
    {
      id: 42893,
      type: 'city',
      name_ru: 'Петергоф',
      name_en: 'Peterhof',
      population: 85177
    },
    {
      id: 42908,
      type: 'city',
      name_ru: 'Шушары',
      name_en: 'Shushary',
      population: 84979
    },
    {
      id: 42283,
      type: 'city',
      name_ru: 'Парголово',
      name_en: 'Pargolovo',
      population: 67505
    },
    {
      id: 42261,
      type: 'city',
      name_ru: 'Кронштадт',
      name_en: 'Kronstadt',
      population: 44321
    },
    {
      id: 42892,
      type: 'city',
      name_ru: 'Ломоносов',
      name_en: 'Lomonosov',
      population: 42971
    },
    {
      id: 42325,
      type: 'city',
      name_ru: 'Сестрорецк',
      name_en: 'Sestroretsk',
      population: 42189
    },
    {
      id: 42912,
      type: 'city',
      name_ru: 'Металлострой',
      name_en: null,
      population: 29891
    }
  ]
}

Районы внутри СПб.

searchPlaces('"Санкт-Петербург" район', 10).then(console.log);

{
  searchPlaces: [
    {
      id: 3842,
      type: 'division',
      name_ru: 'Приморский район',
      name_en: null,
      population: 568516
    },
    {
      id: 3853,
      type: 'division',
      name_ru: 'Калининский район',
      name_en: null,
      population: 533597
    },
    {
      id: 4730,
      type: 'division',
      name_ru: 'Красносельский район',
      name_en: null,
      population: 397609
    },
    {
      id: 4653,
      type: 'division',
      name_ru: 'Фрунзенский район',
      name_en: null,
      population: 394972
    },
    {
      id: 3850,
      type: 'division',
      name_ru: 'Красногвардейский район',
      name_en: null,
      population: 357498
    },
    {
      id: 4733,
      type: 'division',
      name_ru: 'Московский район',
      name_en: null,
      population: 354525
    },
    {
      id: 3852,
      type: 'division',
      name_ru: 'Кировский район',
      name_en: null,
      population: 336248
    },
    {
      id: 4737,
      type: 'division',
      name_ru: 'Колпинский район',
      name_en: null,
      population: 191847
    },
    {
      id: 4662,
      type: 'division',
      name_ru: 'Петродворцовый район',
      name_en: null,
      population: 143154
    },
    {
      id: 4654,
      type: 'division',
      name_ru: 'Невский район',
      name_en: 'Nevsky District',
      population: 527861
    }
  ]
}