Google Maps API
Находите публичные места, получайте нормализованные данные по известным URL Maps и собирайте публичные отзывы с привязанным к источнику контекстом места и автора.
Доступные API Google Maps
Используйте Search для поиска по запросу и местоположению, Place Details — для известных URL Maps, а Reviews — для ограниченного сбора публичных отзывов.
Какие данные Google Maps можно получить?
SocQ возвращает нормализованные публичные записи PlaceItem для исследования локаций, поиска компаний, обогащения данных и снимков рынка на определенный момент.
Идентификаторы места
Получайте доступные ID мест, названия, категории, исходные URL, типы записей и метки времени сбора.
Адреса и география
Сохраняйте доступные отформатированные адреса, метки местоположения, города, регионы, страны, широту и долготу.
Публичные контакты
Собирайте публичные номера телефонов и сайты, если они есть в результате поиска.
Рейтинги и число отзывов
Сохраняйте доступный рейтинг и число отзывов, указанные источником, не додумывая отсутствующие значения.
Описания и категории
Используйте доступный текст описания и метки категорий, чтобы классифицировать результаты и составлять шорт-листы мест.
Метаданные задачи и пагинации
Отслеживайте статус задачи и result_count, затем листайте сохраненные записи PlaceItem с помощью next_cursor и has_more.
Текст местоположения и координаты
Google Maps Search всегда требует query и location. В текущей спецификации координаты — это необязательный дополнительный контекст, а не замена location.
| Вариант входных данных | Поведение | Когда использовать |
|---|---|---|
| только location | Текст местоположения объединяется с query для поиска | Поиск по городу, району, ориентиру или адресу |
| location и обе координаты | location остается обязательным, а координаты передаются как lat и long | Есть проверенный географический центр |
| location и одна координата | Переданная координата передается отдельно | Только если частичный географический контекст задан намеренно |
| country и zoom_level | Необязательный контекст передается вместе со строкой поиска | Запросу нужна подсказка о стране или явный масштаб от 0 до 21 |
Как работает API Google Maps
Отправьте ограниченный поиск мест, дождитесь асинхронного сбора и листайте нормализованные записи, сохраненные для задачи.
1. Определите поиск мест
Выберите конкретный query и обязательный location, затем добавьте только тот проверенный необязательный географический контекст, который вам нужен.
2. Отправьте задачу и отслеживайте ее
Отправьте POST-запрос, сохраните task_id и опрашивайте /v1/tasks/{task_id}, пока обработка не завершится успешно или с ошибкой.
3. Читайте нормализованные места
Обрабатывайте data.results.items и переходите по next_cursor, пока has_more равно true.
Отправьте query и location с небольшим лимитом результатов, затем читайте нормализованные результаты PlaceItem через общий эндпоинт задач.
curl -X POST "https://api.socq.ai/v1/google-maps/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"coffee","location":"New York, NY","country":"US","results_limit":3}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueТипичные сценарии использования API Google Maps
Поиск местных компаний
Находите публичные компании, соответствующие категории или услуге, в пределах города, района, ориентира или адреса.
Обогащение данных о местах
Добавляйте доступные контакты, адрес, категорию, рейтинг, число отзывов, URL и координаты к имеющимся кандидатам-местам.
Географические снимки рынка
Собирайте ограниченные наборы результатов для отдельно заданных территорий и сравнивайте охват публичных мест в конкретные моменты сбора.
Очереди проверки
Составляйте шорт-лист по публичным полям идентичности, контактов, рейтинга и географии для последующей проверки или отдельного сбора подробных данных.
Ограничения и политика публичных данных
Результаты — это публичные записи на определенный момент. Доступность поиска и полнота полей зависят от того, что источник показывает по переданному запросу.
- query и location — обязательные непустые строки; location нельзя заменить координатами.
- country, latitude, longitude и zoom_level необязательны; текущая реализация принимает latitude и longitude независимо друг от друга.
- zoom_level должен быть целым числом от 0 до 21, а results_limit по умолчанию равен 100 и принимает значения от 1 до 2 000.
- results_limit — это максимум для сбора, а параметр limit в GET-запросе задачи управляет размером каждой страницы ответа с сохраненными результатами.
- В публичных результатах могут отсутствовать описания, категории, контакты, рейтинги, число отзывов, URL или отдельные географические поля.
- Повторяющиеся идентификаторы сохраняются в задаче один раз, поэтому result_count может быть меньше числа строк, полученных из источника.
Частые вопросы об API Google Maps
Что такое API Google Maps?
API Google Maps асинхронно ищут публичные места, получают данные по известным URL мест и собирают публичные отзывы в виде нормализованных записей. Search принимает query и location и возвращает записи PlaceItem с доступными полями идентичности, адреса, контактов, рейтинга, числа отзывов, URL и координат.
Что требуется для Search?
Search требует непустые строки query и location. Параметры country, latitude, longitude, zoom_level и results_limit необязательны.
Чем пагинация сбора отличается от пагинации ответа?
results_limit ограничивает число записей, собираемых по переданному поиску. После успешного завершения эндпоинт задач возвращает сохраненные записи страницами, размер которых управляется отдельными параметрами limit и next_cursor.
Почему поля места могут быть null?
Публичный результат поиска может не содержать всех полей контактов, рейтинга, отзывов, описания, URL, адреса или координат. Нормализованная схема сохраняет такие отсутствующие значения как null.
Сколько стоят результаты Google Maps Search?
Каждое сохраненное место стоит 0,15 кредита. Предварительная оценка использует results_limit или 100, если он не указан, а при успешном завершении расчет ведется по фактическому числу сохраненных результатов.
Объединяйте данные разных платформ для более полной бизнес-аналитики
Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.
Google Play API
Собирайте публичные данные о приложениях Google Play, рейтинги категорий и отзывы по известным URL магазина в виде нормализованных записей приложений и отзывов.
Amazon API
Ищите публичные товары Amazon и собирайте нормализованные записи карточек товаров, бестселлеров, отзывов, профилей продавцов и витрин авторов с поддерживаемых маркетплейсов.
Apple App Store API
Собирайте публичные данные о приложениях Apple App Store, рейтинги категорий и отзывы по известным URL магазина в виде нормализованных записей приложений и отзывов.
SEO API
Запрашивайте органическую выдачу Google в реальном времени, сравнивайте спрос и сложность продвижения по ключевым словам, расширяйте исходные запросы, находите ключевые слова и страницы, которые обеспечивают сайту видимость в поиске, классифицируйте поисковый интент и собирайте результаты Google News, Google Images, Google Autocomplete, Bing и YouTube. Все эндпоинты используют один API-ключ SocQ, асинхронный процесс задач и нормализованный формат результатов.
Telegram API
Читайте открытые Telegram-каналы по ссылкам t.me: профили каналов с числом подписчиков, публикации с просмотрами и реакциями, отдельные публикации, комментарии из групп обсуждения, похожие каналы и поиск по всей истории.
Link in Bio API
Превращайте единственную ссылку из био автора в Instagram, TikTok или YouTube в структурированные данные: отображаемое имя, био, аватар, указанный контактный email, связанные профили в соцсетях и каждую кнопку страницы с заголовком и адресом.


