
A localização exata chega ao Google AI Mode, aos AI Overviews e à busca
Use payload.location em tarefas GOOGLE, AIMODE e GOOGLE_SERP para receber a AI Overview, a resposta do AI Mode e os resultados que um usuário vê naquele local.

Use country CN ou HK em tarefas CHATGPT, GEMINI e GOOGLE para receber as respostas que os usuários da China continental e de Hong Kong veem.
CHATGPT: envie country: "CN" e o ChatGPT responde como a um usuário da China continental, em Pequim por padrão.CHATGPT: envie country: "HK" e o ChatGPT responde como a um usuário de Hong Kong, em Central (中環) por padrão.GEMINI: envie country: "CN" e o Gemini responde como a um usuário da China continental, em Pequim por padrão.GOOGLE: envie country: "CN" para receber o AI Overview que o Google mostra a um usuário da China continental, em Pequim por padrão.payload.location, como 王府井 em Pequim ou 旺角 em Hong Kong. O resultado o devolve em location.Cada tarefa CN ou HK pergunta ao ChatGPT como um usuário cujo dispositivo está nesse mercado: em Pequim ou em Central, ou no lugar indicado em payload.location. O ChatGPT responde perguntas sobre lugares próximos para esse ponto. Ao perguntar 附近有什么药店? a partir de 王府井, ele listou seis farmácias entre 312 e 938 metros de distância e citou o Baidu Maps.
Tarefas GEMINI para CN perguntam ao Gemini a partir de um dispositivo no mesmo ponto. Ao perguntar 附近有什么药店? sem local, o Gemini citou farmácias ao redor de 前门, em Pequim, entre 400 e 650 metros, com links do Google Maps, nas 11 verificações em produção. A partir de 王府井, a mais próxima ficava a 350 metros.
Tarefas GOOGLE para CN abrem o Google como os usuários da China continental o acessam: os resultados internacionais do Google (gl=us), a partir de um dispositivo em Pequim ou no seu payload.location. O AI Overview e os resultados orgânicos vêm dessa mesma página. Em produção, as 7 perguntas em chinês simplificado sobre pagamento móvel, entrega de comida, poupança, celulares, bicicletas elétricas, compras online e pontos turísticos receberam um AI Overview em chinês simplificado para o mercado continental: 手机支付用哪个好? citou 微信支付 e 支付宝, e 外卖软件用哪个最好? citou 美团 e 饿了么. Para 附近有什么药店?, o AI Overview listou farmácias do distrito de Xicheng, em Pequim; a partir de 王府井, listou farmácias da 王府井大街. Tarefas AIMODE para CN também respondem para o mercado continental, em chinês simplificado.
Para perguntas sobre o mercado como um todo, escreva o prompt no idioma desse mercado. Em chinês simplificado, o ChatGPT respondeu perguntas sobre juros de poupança, entrega de comida e pagamento móvel para o mercado continental em 42 de 45 testes, citando 美团, 淘宝闪购, 京东外卖, 支付宝, 微信支付 e bancos do continente; as outras 3 perguntaram antes de qual região o usuário falava. O Gemini respondeu para o continente as 23 perguntas sobre pagamento móvel, poupança e pontos turísticos e citou primeiro 美团 e 饿了么 nas 11 respostas sobre entrega de comida; 8 delas também mencionaram apps do exterior, como o DoorDash. Em cantonês, o ChatGPT respondeu 外賣app邊個最好? com os apps de Hong Kong, Keeta e foodpanda.
payload.location aceita um lugar dentro do mercado da tarefa: China continental para CN e Hong Kong para HK. Escreva como as pessoas de lá escrevem, com até 200 caracteres. Quando você envia um lugar, o resultado traz location: o lugar, as coordenadas e o tipo de lugar reconhecido.
Os exemplos abaixo são tarefas CHATGPT. Para o Gemini, use GEMINI em taskType. Para os AI Overviews do Google, use GOOGLE e envie a pergunta em payload.query.
Envie a requisição com a sua chave de API no cabeçalho Authorization.
curl -X POST https://api.querying.ai/v1/async/task \
-H "Authorization: Bearer $QUERYING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"taskType": "CHATGPT",
"payload": { "prompt": "附近有什么药店?", "country": "CN", "location": "王府井" }
}'taskTypestringObrigatórioCHATGPT ou GOOGLE.payload.promptstringObrigatóriopayload.countrystringUS, KR ou JP. Padrão US.payload.locationstringcountry, como uma estação, um bairro ou um endereço, com até 200 caracteres. O motor responde como a um usuário que está ali. Para CHATGPT, GEMINI, GOOGLE, AIMODE e GOOGLE_SERP.webhook.urlstringidempotencyKeystringUma tarefa concluída chega assim, resumida para facilitar a leitura.
{
"success": true,
"task": {
"id": "6e6625b6-2d91-4f17-88a5-9b53df805960",
"taskType": "CHATGPT",
"status": "COMPLETED",
"createdAt": "2026-10-03T17:25:13.462Z"
},
"credits": { "creditsToCharge": 2, "creditsCharged": 2 },
"response": {
"text": "你附近目前有这些药店:\n\n- 低价药房顺鸿堂药店 — 约 **354 米**\n- 正义药店 — 约 **312 米**\n- 龙华康健大药房 — 约 **514 米**\n…",
"sources": [
{
"position": 1,
"url": "https://map.baidu.com/mobile/webapp/place/list/…",
"label": "百度地图",
"attribution": "map.baidu.com"
}
],
"searchQueries": ["北京 东城区 附近 药店 营业时间"],
"location": {
"name": "王府井, 王府井大街, 台基厂社区, 东华门街道, 首都功能核心区, 东城区, 北京市, 100010, 中国",
"query": "王府井",
"latitude": 39.90695,
"longitude": 116.40528,
"precision": "railway"
}
}
}task.statusstringQUEUED, PROCESSING e, no fim, COMPLETED com a resposta ou FAILED com error.credits.creditsChargedintegerresponse.textstringresponse.locationobjectquery, name, latitude, longitude e precision.response.sourcesarrayposition, url e label.response.searchQueriesarrayA requisição devolve a tarefa na hora, com status QUEUED. Consulte GET /v1/async/task/{id} até status virar COMPLETED ou FAILED, ou adicione webhook.url e a tarefa concluída chega ao seu servidor com os mesmos task, credits e response. Os resultados ficam disponíveis por 24 horas após o fim da tarefa.
curl https://api.querying.ai/v1/async/task/$TASK_ID \
-H "Authorization: Bearer $QUERYING_API_KEY"LOCATION_NOT_FOUNDHTTP 422payload.location é desconhecido dentro de country. Acrescente o bairro ou a cidade e envie de novo.LOCATION_LOOKUP_UNAVAILABLEHTTP 503Uma tarefa CN ou HK custa o mesmo que qualquer tarefa do seu mecanismo, por tarefa concluída: 2 créditos no ChatGPT, 1 crédito no Gemini e 2 créditos nos AI Overviews do Google.

Use payload.location em tarefas GOOGLE, AIMODE e GOOGLE_SERP para receber a AI Overview, a resposta do AI Mode e os resultados que um usuário vê naquele local.

Use payload.location em tarefas CHATGPT e GEMINI para receber a resposta que um usuário vê naquele local.
Receba atualizações do produto por e-mail.