Fragen Sie ChatGPT und Gemini von einem genauen Ort aus

Mit payload.location liefern CHATGPT- und GEMINI-Aufgaben die Antwort, die jemand an diesem Ort sieht.

Was Sie erhalten

• Antworten für ein Viertel: Lokale Empfehlungen beziehen sich auf die Umgebung des Punktes, den Sie angeben, etwa einen Bahnhof, ein Geschäft oder eine Straßenecke.
• location in jedem Ergebnis mit Ort: die Koordinaten, von denen aus gefragt wurde.
• Dieselbe Einstellung im Playground: Geben Sie einen Ort oder Koordinaten unter Ort (optional) neben der Länder-Schaltfläche ein.

So funktioniert es

Fragen wie „ein guter Zahnarzt in der Nähe“ oder „wo esse ich zu Mittag“ hängen davon ab, wo sich die Person befindet. ChatGPT und Gemini beantworten sie für ihren Standort, deshalb nennt derselbe Prompt in Gangnam andere Praxen als in Busan. Setzen Sie payload.location auf einen Punkt innerhalb des country der Aufgabe, und querying.ai fragt die Engine wie jemand, der genau dort steht.

Senden Sie den Punkt als latitude und longitude in Dezimalgrad, wie in der Anfrage unten. Karten-Apps zeigen diese Zahlen für jeden gewählten Punkt, und der Playground findet sie zu einem Ortsnamen. Jedes Ergebnis liefert denselben Punkt als location zurück.

Der Ort funktioniert bei CHATGPT-, GEMINI-, GOOGLE-, AIMODE- und GOOGLE_SERP-Aufgaben. Die API prüft die Engine direkt beim Absenden und antwortet für jede andere Engine mit LOCATION_UNSUPPORTED. So antwortet jede ausgeführte Aufgabe für den Ort, den Sie gewählt haben.

Einsatzbereiche

• Prüfen Sie, ob KI Ihre Praxis, Ihr Restaurant oder Ihr Geschäft den Menschen im eigenen Viertel empfiehlt.
• Stellen Sie dieselbe Frage aus mehreren Vierteln oder Städten und sehen Sie, wo Wettbewerber vorn liegen.
• Verfolgen Sie jede Filiale einer Kette von ihrer eigenen Adresse aus, mit einem Prompt-Set pro Standort.

Anfrage senden

Senden Sie die Anfrage mit Ihrem API-Schlüssel im Header 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": "Best coffee shops near me for working on a laptop",
      "country": "US",
      "location": { "latitude": 40.72288, "longitude": -73.99875 }
    }
  }'

Felder der Anfrage

taskTypestringPflicht

Die Engine, die die Aufgabe ausführt, etwa CHATGPT oder GOOGLE.

payload.promptstringPflicht

Die Frage, so formuliert, wie ein Nutzer sie in den Chat tippt. Bis zu 100.000 Zeichen.

payload.countrystring

Zweistelliger Ländercode des Markts, aus dem gefragt wird, etwa US, KR oder JP. Standard US.

payload.locationobject

Ein Punkt innerhalb von country, mit latitude (-90 bis 90) und longitude (-180 bis 180) in Dezimalgrad, etwa {"latitude": 37.4979, "longitude": 127.0276}. Die Engine antwortet wie einem Nutzer vor Ort. Für CHATGPT, GEMINI, GOOGLE, AIMODE und GOOGLE_SERP.

webhook.urlstring

Eine HTTPS-Adresse Ihres Servers. Die fertige Aufgabe wird dorthin gesendet, sobald sie abgeschlossen ist.

idempotencyKeystring

Ihre eigene ID für die Anfrage. Jeder Schlüssel erzeugt pro Konto genau eine Aufgabe, ein wiederholter Versand bleibt also eine Aufgabe.

Antwort

So sieht eine fertige Aufgabe aus, für die Lesbarkeit gekürzt.

{
  "success": true,
  "task": {
    "id": "e5aba119-a26e-4f82-a965-35c9234a428b",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:41:03.858Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "Here are several **nearby cafés that look particularly suitable for laptop work**, based on current local listings and work-friendly details:\n\n- The Lost Draft — **0.2 km away**. Laptop-friendly, with Wi-Fi, comfortable seating, and larger tables.\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://awifiplace.com/cities/new-york",
        "label": "Best Coffee Shops to Work in New York (2026) | 103 Cafes with WiFi",
        "attribution": "A Wifi.Place"
      }
    ],
    "searchQueries": [
      "best coffee shops for laptop work near me wifi outlets"
    ],
    "location": { "latitude": 40.72288, "longitude": -73.99875 }
  }
}

task.statusstring

QUEUED, PROCESSING, dann COMPLETED mit der Antwort oder FAILED mit error.

credits.creditsChargedinteger

Für die fertige Aufgabe berechnete Credits. Eine fehlgeschlagene Aufgabe kostet 0.

response.textstring

Die Antwort als reiner Text.

response.locationobject

Der Punkt, für den die Antwort gilt, so wie Sie ihn gesendet haben: latitude und longitude.

response.sourcesarray

Die Seiten, die die Antwort zitiert, in der Reihenfolge der Engine, mit position, url und label.

response.searchQueriesarray

Die Websuchen, die die Engine für die Antwort ausgeführt hat.

Ergebnis abholen

Die Anfrage liefert sofort die Aufgabe mit status QUEUED. Fragen Sie GET /v1/async/task/{id} ab, bis status COMPLETED oder FAILED ist, oder geben Sie webhook.url an, dann kommt die fertige Aufgabe mit denselben task, credits und response auf Ihrem Server an. Ergebnisse bleiben 24 Stunden nach Abschluss abrufbar.

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

Fehler

LOCATION_UNSUPPORTEDHTTP 422

payload.location gilt für CHATGPT, GEMINI, GOOGLE, AIMODE und GOOGLE_SERP. Andere Engines liefern diesen Code beim Senden.

Preis

Eine Aufgabe mit Ort kostet so viel wie jede andere Aufgabe der Engine: 2 Credits bei ChatGPT und 1 Credit bei Gemini pro abgeschlossener Aufgabe.