Genaue Standorte jetzt auch für Google AI Mode, AI Overviews und die Suche

Mit payload.location liefern GOOGLE-, AIMODE- und GOOGLE_SERP-Aufgaben die AI Overview, die AI-Mode-Antwort und die Suchergebnisse, die jemand an diesem Ort sieht.

Was sich ändert

• GOOGLE-, AIMODE- und GOOGLE_SERP-Aufgaben akzeptieren payload.location und liefern die AI Overview, die AI-Mode-Antwort und die Suchergebnisse, die Google jemandem an dem angegebenen Ort zeigt: an einem Bahnhof, in einem Bezirk oder an einer Adresse.
• location in jedem Ergebnis mit Ort, dasselbe Objekt wie bei ChatGPT und Gemini: der angewendete Ort, seine Koordinaten und die Art des erkannten Ortes.
• GEMINI-Aufgaben akzeptieren einen Ort in allen Ländern, in denen Gemini verfügbar ist, jetzt auch in Deutschland, im Vereinigten Königreich und im Iran.
• Das Ortsfeld im Playground für Google AI Overviews und Google AI Mode unter Antwort-Engines und für Google Search unter Suchmaschinen. Es schlägt einen Ort im gewählten Land vor, etwa 강남역 für KR oder 旺角 für HK.

So funktioniert es

Google antwortet für den genauen Standort, den ein Telefon oder Browser freigibt, deshalb zeigt „Grippeimpfung in der Nähe“ Praxen rund um diesen Punkt. Bei einer Aufgabe mit Ort gibt querying.ai die Koordinaten Ihres Ortes vor der Suche auf dieselbe Weise frei, und Google antwortet wie jemandem, der genau dort steht. Das country der Aufgabe legt Markt und Sprache der Ergebnisse fest, payload.location den Punkt darin.

In Tests nannte AI Mode in allen 50 Antworten mit Ort den angefragten Ort, in acht koreanischen Städten und an zehn Orten in den USA, Japan, Deutschland und dem Vereinigten Königreich. AI Overviews berücksichtigten den Ort in allen 18 Antworten mit Ort, und Gemini antwortete in jeder abgeschlossenen Antwort aus Deutschland und dem Vereinigten Königreich für die angefragte Stadt.

Schreiben Sie den Ort so, wie man ihn dort schreibt, mit bis zu 200 Zeichen innerhalb des country der Aufgabe. AI Mode, AI Overviews und Suchergebnisse halten ihn als location fest, mit query, name, latitude, longitude und precision.

Einsatzbereiche

• Prüfen Sie, ob Ihre Praxis, Ihr Restaurant oder Ihr Geschäft in der AI Overview und der AI-Mode-Antwort für Suchen in der Umgebung erscheint.
• Stellen Sie Google AI Mode, AI Overviews, ChatGPT und Gemini dieselbe Frage von einer Adresse aus und vergleichen Sie, was jede Engine empfiehlt.
• Verfolgen Sie die Suchergebnisse rund um jede Filiale einer Kette, mit einem Set von Suchanfragen pro Adresse.

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": "AIMODE",
    "payload": {
      "query": "where can I get a flu shot near me",
      "country": "HK",
      "location": "旺角"
    }
  }'

Felder der Anfrage

taskTypestringPflicht

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

payload.querystringPflicht

Die Suchanfrage, so formuliert, wie ein Nutzer sie ins Suchfeld tippt.

payload.countrystring

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

payload.locationstring

Ein Ort innerhalb von country, etwa ein Bahnhof, ein Viertel oder eine Adresse, bis zu 200 Zeichen. 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": "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, 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.markdownstring

Die Antwort mit Überschriften, Listen und Tabellen, in jedem Ergebnis.

response.sourcesarray

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

response.locationobject

Der Ort, für den die Antwort gilt: query, name, latitude, longitude und precision.

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.

LOCATION_NOT_FOUNDHTTP 422

Der Ort in payload.location ist innerhalb von country unbekannt. Ergänzen Sie Bezirk oder Stadt und senden Sie erneut.

LOCATION_LOOKUP_UNAVAILABLEHTTP 503

Die Ortssuche ist kurz unterbrochen. Senden Sie dieselbe Anfrage erneut, bereits gefundene Orte werden sofort verarbeitet.

Preis

Eine Aufgabe mit Ort kostet so viel wie jede andere Aufgabe der Engine, pro abgeschlossener Aufgabe: 2 Credits bei AI Mode und AI Overviews, 1 Credit bei Suchergebnissen und 1 Credit bei Gemini.