Google-Places-Ergebnisse per API (GOOGLE_PLACES)

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.

Anfrage

Diese Anfrage ruft die ersten 100 Orte ab, die Google für Langzeitpflege in Manville, Rhode Island, listet:

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:

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 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:

{
  "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: `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.

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.
Weitere Anfragefehler stehen unter Fehler.

Verwandt

Google Search für eine Ergebnisseite mit ihrem Local Pack
Regionen und Standort
Credits und Limits

Erste Schritte

Grundlagen

Antwort-Engines

Suche und Webdaten

Anfrageoptionen

Recherche

GEO-Monitoring

Konto und Daten

Google-Places-Ergebnisse per API (GOOGLE_PLACES)

Anfrage

Parameter

Antwort

Credits

Grenzen und Fehler

Verwandt

​Anfrage

​Parameter

​Antwort

​Credits

​Grenzen und Fehler

​Verwandt

Anfrage

Parameter

Antwort

Credits

Grenzen und Fehler

Verwandt