> ## Documentation Index > Fetch the complete documentation index at: https://docs.querying.ai/llms.txt > Use this file to discover all available pages before exploring further. # Google-Places-Ergebnisse per API (GOOGLE_PLACES) > Bis zu 100 Orte aus Googles Ortsliste zu einer lokalen Suche abrufen, gesucht aus der Stadt Ihrer Wahl. `GOOGLE_PLACES` liefert die Orte, die Google im Tab „Orte“ zu einer Suche listet, also die Liste, die sich über „Weitere Orte“ unter einem Local Pack öffnet. Es liest bis zu fünf Seiten mit je 20 Orten und sucht jede Seite aus derselben Stadt. So erhalten Sie bis zu 100 Orte in der Reihenfolge, in der Google sie dort einstuft. Nutzen Sie es, um den Rang eines Unternehmens in der gesamten lokalen Liste einer Stadt zu verfolgen, oder um die Unternehmen zu sammeln, die Google für eine Dienstleistung in einer Stadt zeigt. | | | | - | - | | `taskType` | `GOOGLE_PLACES` | | Eingabe | `query` (Pflicht); `city` oder `uule`, `limit`, `country` | | Credits | 1 pro gelesener Orte-Seite. Eine Seite enthält 20 Orte. | | Land | Standard ist `US`. Jeder ISO-3166-1-Alpha-2-Code. | | Standort | Festgelegt mit `city` oder `uule`. Siehe [Regionen und Standort](https://docs.querying.ai/de/engines/capacity.md). | ## Anfrage Diese Anfrage ruft die ersten 100 Orte ab, die Google für Langzeitpflege in Manville, Rhode Island, listet: ```bash theme={"theme":"css-variables"} curl -X POST https://api.querying.ai/v1/async/task \ -H "Authorization: Bearer $QUERYING_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "taskType": "GOOGLE_PLACES", "payload": { "query": "long term care near me", "city": "Manville, Rhode Island, United States", "limit": 100 } }' ``` Wenn Ihr System Googles `uule` bereits pro Ort speichert, senden Sie ihn statt `city`. Dieser Wert steht für Reno, Nevada: ```bash theme={"theme":"css-variables"} curl -X POST https://api.querying.ai/v1/async/task \ -H "Authorization: Bearer $QUERYING_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "taskType": "GOOGLE_PLACES", "payload": { "query": "Reno attorney", "uule": "w+CAIQICIbUmVubywgTmV2YWRhLCBVbml0ZWQgU3RhdGVz", "limit": 100 } }' ``` Der Task läuft asynchron. Lesen Sie das Ergebnis wie unter [Asynchrone Tasks](https://docs.querying.ai/de/concepts/async-tasks.md) beschrieben. Ein Task mit `limit: 100` ist meist nach ein bis zwei Minuten abgeschlossen. ## Parameter | Feld | Pflicht | Beschreibung | | - | - | - | | `query` | Ja | Die Suche, 1-100.000 Zeichen. `prompt` wird akzeptiert, wenn `query` fehlt. | | `city` | Nein | Der Ort, aus dem gesucht wird, so benannt, wie Google Orte benennt: Stadt, Bundesstaat oder Region und Land, etwa `"Reno, Nevada, United States"`. Bis zu 100 Zeichen. Das Ergebnis liefert ihn als `city` zurück. | | `uule` | Nein | Googles eigener Standortparameter in der `w+`-Form, wie Rank-Tracker ihn speichern, unverändert an Google gesendet. Senden Sie `city` oder `uule`. Das Ergebnis liefert ihn als `uule` zurück. | | `limit` | Nein | Wie viele Orte geliefert werden, eine Ganzzahl von 1 bis 100. Standard ist `20`, eine Seite. Senden Sie `100` für die vollständige Liste. | | `country` | Nein | Der Google-Markt, in dem gesucht wird. Standard ist `US`. | Ohne `city` und `uule` wählt Google den Ort, aus dem gesucht wird. ## Antwort Zum Beispiel die Anfrage für Manville oben: ```json theme={"theme":"css-variables"} { "places": [ { "position": 1, "page": 1, "name": "...", "placeId": "...", "location": { "address": "...", "...": "..." }, "mapsUrl": "https://maps.google.com/?cid=...", "reviews": [{ "...": "..." }], "category": "..." }, { "position": 21, "page": 2, "...": "..." } ], "pages": 5, "city": "Manville, Rhode Island, United States" } ``` | Feld | Beschreibung | | - | - | | `places` | Immer vorhanden, in Googles Reihenfolge. Jeder Ort trägt die Felder eines Local-Pack-Orts in `map` von [Google Search](https://docs.querying.ai/de/engines/google-serp.md): `name`, `placeId`, `location` (`address`, `latitude`, `longitude`), `phoneNumber`, `url`, `mapsUrl`, `reviews`, `category`, `price`, `snippet` und `image`, so wie Google sie zeigt. | | `places[].position` | Der Rang des Orts in der gesamten Liste, ab 1. Er zählt über Seiten hinweg weiter. | | `places[].page` | Die Orte-Seite, von der der Ort stammt, 1 bis 5. | | `pages` | Wie viele Orte-Seiten gelesen wurden. Diese werden berechnet. | | `googleLocation` | Der Ort, aus dem Google nach eigener Anzeige gesucht hat. Nur vorhanden, wenn die Seite ihn anzeigt. | | `city` | Die gesendete `city`, wenn Sie eine gesendet haben. | | `uule` | Der gesendete `uule`, wenn Sie einen gesendet haben. | Ein Ort, den eine spätere Seite erneut listet, wird einmal gezählt. Endet Googles Liste vor `limit`, enthält `places` alle Orte, die Google gelistet hat; eine Kleinstadt hat oft weniger als 100. Felder, die Google für einen Ort nicht zeigt, werden weggelassen. Behandeln Sie jedes Feld außer `name`, `position` und `page` als optional. ## Credits Jede gelesene Orte-Seite kostet 1 Credit. Beim Einreichen reserviert der Task die Credits für die Seiten, die `limit` braucht, eine Seite je 20 Orte: 1 beim Standard, 5 bei `limit: 100`. Bei Abschluss werden die gelesenen Seiten berechnet, eine Liste, die Google nach drei Seiten beendet, kostet also 3. Ein fehlgeschlagener Task kostet 0. Siehe [Credits und Limits](https://docs.querying.ai/de/concepts/credits-and-limits.md). ## Grenzen und Fehler * Ein leeres `places` in einem abgeschlossenen Task bedeutet, dass Google für die Suche an diesem Standort keine Orte gelistet hat. Das wird vor der Rückgabe in einem zweiten Browser bestätigt und kostet 1 Credit. * `limit` außerhalb von 1-100, eine leere oder über 100 Zeichen lange `city` oder eine `city` zusammen mit `uule` oder `location` liefert `422 VALIDATION_ERROR`. * Ein `uule`, das kein UULE in `w+`-Form ist, liefert `400 VALIDATION_ERROR`. * `location` liefert `422`. Legen Sie den Ort mit `city` oder `uule` fest. * `include.rawResponse` hat keine Wirkung, `include.html` und `include.analysis` liefern `422`. Siehe [Markdown und Rohantworten](https://docs.querying.ai/de/engines/response-options.md). * Weitere Anfragefehler stehen unter [Fehler](https://docs.querying.ai/de/concepts/errors.md). ## Verwandt * [Google Search](https://docs.querying.ai/de/engines/google-serp.md) für eine Ergebnisseite mit ihrem Local Pack * [Regionen und Standort](https://docs.querying.ai/de/engines/capacity.md) * [Credits und Limits](https://docs.querying.ai/de/concepts/credits-and-limits.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.