정확한 위치 지정이 Google AI Mode, AI Overview, 검색 결과로 넓어졌어요

GOOGLE, AIMODE, GOOGLE_SERP 태스크에 payload.location을 넣어 그 장소의 사용자가 보는 AI Overview, AI Mode 답변, 검색 결과를 받으세요.

달라진 점

• GOOGLE, AIMODE, GOOGLE_SERP 태스크가 payload.location을 받습니다. 역, 구, 도로명주소처럼 지정한 장소에 있는 사용자에게 Google이 보여 주는 AI Overview, AI Mode 답변, 검색 결과를 받습니다.
• 위치를 지정한 결과의 location: ChatGPT, Gemini와 같은 객체로, 적용된 장소, 좌표, 일치한 장소의 종류가 담깁니다.
• GEMINI 태스크는 Gemini가 서비스하는 모든 국가에서 위치를 받습니다. 이제 독일, 영국, 이란도 포함됩니다.
• Playground의 위치 칸: 답변 엔진 탭의 Google AI Overviews, Google AI Mode와 검색 엔진 탭의 Google Search에 나옵니다. KR이면 강남역, HK면 旺角처럼 선택한 국가의 장소를 예시로 보여 줍니다.

동작 방식

Google은 휴대폰이나 브라우저가 공유한 정확한 위치를 기준으로 답하므로, “근처 독감 예방접종”을 검색하면 그 지점 주변 병원이 나옵니다. 위치를 지정한 태스크는 querying.ai가 검색 전에 같은 방식으로 그 장소의 좌표를 공유하므로, Google이 그 자리에 있는 사용자에게 답하듯 답합니다. 태스크의 country가 시장과 결과 언어를 정하고, payload.location이 그 안의 지점을 정합니다.

실측에서 AI Mode는 위치를 지정한 답변 50건 모두 요청한 장소를 이름으로 언급했습니다. 한국 8개 도시와 미국, 일본, 독일, 영국의 10곳에서 잰 결과입니다. AI Overview는 위치를 지정한 답변 18건 모두 장소를 반영했고, Gemini는 독일과 영국에서 완료된 답변 모두 요청한 도시를 기준으로 답했습니다.

장소는 태스크 country 안에서 현지 표기 그대로 200자까지 적으세요. AI Mode, AI Overview, 검색 결과 모두 적용된 장소를 location으로 기록하며 query, name, latitude, longitude, precision이 담깁니다.

이렇게 활용하세요

• 내 병원, 식당, 매장이 그 주변에서 한 검색의 AI Overview와 AI Mode 답변에 나오는지 확인합니다.
• 같은 주소에서 Google AI Mode, AI Overview, ChatGPT, Gemini에 같은 질문을 던져 엔진마다 무엇을 추천하는지 비교합니다.
• 프랜차이즈 지점마다 그 주소를 기준으로 검색어 세트를 정해 주변 검색 결과를 추적합니다.

요청 보내기

API 키를 Authorization 헤더에 넣어 요청을 보냅니다.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "AIMODE",
    "payload": {
      "query": "where can I get a flu shot near me",
      "country": "HK",
      "location": "旺角"
    }
  }'

요청 필드

taskTypestring필수

실행할 엔진입니다. CHATGPT, GOOGLE 같은 값을 넣습니다.

payload.querystring필수

사용자가 검색창에 입력하듯 쓴 검색어입니다.

payload.countrystring

질문할 시장의 두 글자 국가 코드입니다. US, KR, JP 등. 기본값 US.

payload.locationstring

country 안의 장소입니다. 역, 구, 도로명주소 등 최대 200자. 엔진이 그 자리에 있는 사용자에게 답하듯 답합니다. CHATGPT, GEMINI, GOOGLE, AIMODE, GOOGLE_SERP에서 씁니다.

webhook.urlstring

서버의 HTTPS 주소입니다. 태스크가 끝나는 즉시 결과를 이 주소로 보냅니다.

idempotencyKeystring

요청에 붙이는 고유 ID입니다. 키 하나는 계정에서 태스크 하나를 만들므로, 다시 보내도 태스크는 하나로 유지됩니다.

응답

완료된 태스크는 이런 형태입니다. 길이를 줄여 보여 드립니다.

{
  "success": true,
  "task": {
    "id": "22ae7f29-df83-425a-b614-606c50c81502",
    "taskType": "AIMODE",
    "status": "COMPLETED",
    "createdAt": "2026-10-03T17:54:37.189Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "markdown": "In the **Yau Tsim Mong District** and across Hong Kong, you can get your seasonal influenza vaccination (flu shot) through private medical clinics, private group medical practices, or subsidized public channels…\n\nHere are a few options located right in your area:\n\n- **Private Medical Groups & Clinics:**\n  - **Local Private General Practice Clinics:** Many neighborhood private clinics across Yau Ma Tei, Tsim Sha Tsui, and Mong Kok offer walk-in or appointment-based flu jabs.\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://www.chp.gov.hk/en/features/18630.html",
        "label": "CHP Government Vaccination Programme"
      }
    ],
    "location": {
      "name": "旺角, 亞皆老街, 旺角, 油尖旺區, 九龍, 香港, 中国",
      "query": "旺角",
      "latitude": 22.31931,
      "longitude": 114.16981,
      "precision": "railway"
    }
  }
}

task.statusstring

QUEUED, PROCESSING을 거쳐 답변과 함께 COMPLETED로, 또는 error와 함께 FAILED로 끝납니다.

credits.creditsChargedinteger

끝난 태스크에 청구된 크레딧입니다. 실패한 태스크는 0입니다.

response.textstring

답변 평문입니다.

response.markdownstring

제목, 목록, 표를 살린 답변으로, 모든 결과에 담깁니다.

response.sourcesarray

답변이 인용한 페이지입니다. 엔진이 보여 준 순서대로 position, url, label이 담깁니다.

response.locationobject

답변에 적용된 장소입니다. query, name, latitude, longitude, precision이 담깁니다.

결과 받기

요청하면 status가 QUEUED인 태스크가 바로 돌아옵니다. status가 COMPLETED나 FAILED가 될 때까지 GET /v1/async/task/{id}로 조회하거나, webhook.url을 넣어 같은 task, credits, response를 서버로 받으세요. 결과는 태스크가 끝난 뒤 24시간 동안 조회됩니다.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

오류

LOCATION_UNSUPPORTEDHTTP 422

payload.location은 CHATGPT, GEMINI, GOOGLE, AIMODE, GOOGLE_SERP에서 씁니다. 그 밖의 엔진은 제출할 때 이 코드를 돌려줍니다.

LOCATION_NOT_FOUNDHTTP 422

country 안에서 payload.location의 장소를 찾지 못했습니다. 구나 시를 덧붙여 다시 보내세요.

LOCATION_LOOKUP_UNAVAILABLEHTTP 503

장소 조회가 잠시 멈췄습니다. 같은 요청을 다시 보내면 앞서 찾은 장소는 바로 처리됩니다.

요금

위치를 지정해도 요금은 엔진의 기본 요금 그대로입니다. 완료된 태스크마다 AI Mode와 AI Overview는 2크레딧, 검색 결과와 Gemini는 1크레딧입니다.