C# SDK engine

Google Maps

Google Maps search and place results with local results, place details, photos, reviews and popular times.

engine: google_maps constant: XylopSearchEngines.GoogleMaps GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

var client = new XylopSearchClient(new HttpClient(), "YOUR_API_KEY");

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleMaps,
    new Dictionary<string, string?>
    {
        ["type"] = "search",
        ["q"] = "coffee",
        ["data"] = "data token",
        ["place_id"] = "ChIJ...",
        ["ll"] = "@30.2672,-97.7431,14z",
    });

Для типизированного режима используйте `SearchAsync<TResponse>` и response-модель из `Xylop.Logic.SerpApiResponses.*`, которая входит в пакет C# SDK.

Endpoint

HTTP контракт

URL: https://api.xylop.ru/search
Engine: google_maps
API key: Передается SDK автоматически из настроек клиента.

Входные параметры

Параметры запроса

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_maps`	Google Maps engine.
`type`	string	Да	`search`	search or place.
`q`	string	Нет	coffee	Required for type=search.
`data`	string	Нет	data token	Place data token for type=place.
`place_id`	string	Нет	ChIJ...	Place identifier for type=place.
`ll`	string	Нет	@30.2672,-97.7431,14z	Google Maps viewport.
`hl`	string	Нет	`en`	Interface language.
`gl`	string	Нет	`us`	Country code.

Выходные параметры

Поля ответа

Поле	Тип	Источник	Описание
`search_metadata`	object	пример ответа	Метаданные запроса: статус, идентификатор, время выполнения и служебная информация провайдера.
`search_parameters`	object	пример ответа	Нормализованные параметры, с которыми upstream-поиск выполнил запрос.
`local_results`	array	пример ответа	Локальные результаты: адреса, координаты, рейтинги, телефоны и ссылки.

JSON

Пример ответа

{
  "search_metadata": {
    "status": "Success",
    "google_maps_url": "https://www.google.com/maps/search/coffee"
  },
  "search_parameters": {
    "engine": "google_maps",
    "type": "search",
    "q": "coffee"
  },
  "local_results": [
    {
      "position": 1,
      "title": "Example Coffee",
      "place_id": "ChIJ...",
      "rating": 4.6,
      "reviews": 128,
      "type": "Coffee shop",
      "address": "123 Main St"
    }
  ]
}