Mit der Funktion „Query Autocomplete (Legacy)“ können Sie eine Vorhersage für textbasierte geografische Suchanfragen bereitstellen, indem Sie während der Eingabe vorgeschlagene Suchanfragen zurückgeben.
Query Autocomplete-Anfragen (Legacy)
„Query Autocomplete“ (Legacy) ist Teil der Places API (Legacy) und verwendet denselben API-Schlüssel und dasselbe Kontingent wie die Places API (Legacy).
Mit Query Autocomplete (Legacy) können Sie Ihrer Anwendung geografische Vorhersagen für Suchanfragen in Echtzeit hinzufügen. Anstatt nach einem bestimmten Ort zu suchen, kann ein Nutzer eine kategorische Suche eingeben, z. B. „Pizza in der Nähe von New York“. Der Dienst antwortet mit einer Liste von Suchanfragen, die dem String entsprechen. Da Query Autocomplete (Legacy) sowohl vollständige Wörter als auch Teilstrings abgleichen kann, können Anwendungen Abfragen senden, während der Nutzer tippt, und schon bei der Eingabe Vorschläge ausgeben.
Eine Anfrage für die automatische Vervollständigung von Suchanfragen (Legacy) ist eine HTTP-URL mit folgendem Format:
https://maps.googleapis.com/maps/api/place/queryautocomplete/output?parameters
Dabei kann output entweder json oder xml sein.
Bestimmte Parameter sind erforderlich, um eine Anfrage für die automatische Vervollständigung von Suchanfragen (Legacy) zu starten.
Wie in URLs üblich, werden alle Parameter mit dem Und-Zeichen (&) getrennt. Die Liste der Parameter und ihrer möglichen Werte finden Sie unten.
Erforderliche Parameter
-
Eingabe
Die Textzeichenfolge, nach der gesucht werden soll. Über den Place Autocomplete-Dienst werden mögliche Übereinstimmungen basierend auf dem String zurückgegeben, die nach erkannter Relevanz sortiert werden.
Optionale Parameter
-
Sprache
Die Sprache, in der die Ergebnisse zurückgegeben werden sollen.
- Hier finden Sie eine Liste der unterstützten Sprachen. Die unterstützten Sprachen werden regelmäßig von Google aktualisiert. Diese Liste ist daher möglicherweise nicht vollständig.
-
Wenn
languagenicht angegeben ist, versucht die API, die bevorzugte Sprache zu verwenden, die imAccept-Language-Header angegeben ist. - Die API versucht, eine Straßenadresse bereitzustellen, die sowohl für den Nutzer als auch für Einheimische lesbar ist. Dazu werden Straßenadressen in der lokalen Sprache zurückgegeben, die bei Bedarf in ein für den Nutzer lesbares Schriftsystem transliteriert werden. Dabei wird die bevorzugte Sprache berücksichtigt. Alle anderen Adressen werden in der bevorzugten Sprache zurückgegeben. Alle Adresskomponenten werden in derselben Sprache zurückgegeben, die anhand der ersten Komponente ausgewählt wird.
- Wenn ein Name in der bevorzugten Sprache nicht verfügbar ist, wird die nächstgelegene Übereinstimmung verwendet.
- Die bevorzugte Sprache hat einen geringen Einfluss auf die Ergebnisse, die von der API zurückgegeben werden, und auf die Reihenfolge, in der sie zurückgegeben werden. Der Geocoder interpretiert Abkürzungen je nach Sprache unterschiedlich, z. B. Abkürzungen für Straßentypen oder Synonyme, die in einer Sprache gültig sein können, in einer anderen jedoch nicht. Beispiel: utca und tér sind Synonyme für „Straße“ auf Ungarisch.
-
Standort
Definiert einen Punkt als
latitude,longitude-Koordinaten, um den herum gesucht werden soll. Der Places-Dienst verwendet den Standort, um die Suche so zu gewichten, dass vorzugsweise Ergebnisse für Orte angezeigt werden, die sich innerhalb des durchlocationundradiusdefinierten Bereichs befinden. Ergebnisse außerhalb dieses Bereichs können aber trotzdem angezeigt werden.Der Parameterlocationkann überschrieben werden, wennqueryeinen expliziten Ort wieMarket in Barcelonaenthält. Die Verwendung von Anführungszeichen um die Anfrage kann sich auch auf die Gewichtung vonlocationundradiusauswirken. -
kompensiert
Die Position des letzten Zeichens im Eingabeterm, das vom Dienst zum Abgleichen von Vorhersagen verwendet wird. Wenn die Eingabe beispielsweise
Googleund der Offset 3 ist, wird der DienstGooabgleichen. Der durch den Offset bestimmte String wird nur mit dem ersten Wort im Eingabeterm abgeglichen. Wenn der Eingabeterm beispielsweiseGoogle abcund der Offset 3 ist, versucht der Dienst,Goo abcabzugleichen. Wenn kein Offset angegeben wird, wird der gesamte Zeitraum verwendet. Der Offset sollte in der Regel auf die Position des Textcursors festgelegt werden. -
Umkreis
Definiert die Entfernung (in Metern), innerhalb derer Ortsangaben zurückgegeben werden sollen. Wenn Sie die Parameter
locationundradiusweitergeben, können Sie die Ergebnisse zugunsten eines festgelegten Kreises gewichten. Dadurch wird der Places-Dienst angewiesen, vorzugsweise Ergebnisse für Orte anzuzeigen, die sich innerhalb dieses Kreises befinden. Ergebnisse außerhalb dieses Bereichs können aber trotzdem angezeigt werden.Der Radius wird automatisch auf einen Höchstwert begrenzt, der vom Suchtyp und anderen Parametern abhängt.
- Automatische Vervollständigung: 50.000 Meter
-
Nearby Search:
- mit
keywordodername: 50.000 Meter -
ohne
keywordodername-
Bis zu 50.000 Meter, dynamisch angepasst basierend auf der Dichte des Gebiets, unabhängig vom Parameter
rankby. -
Wenn Sie
rankby=distanceverwenden, wird der Radiusparameter nicht akzeptiert und es wird einINVALID_REQUESTzurückgegeben.
-
Bis zu 50.000 Meter, dynamisch angepasst basierend auf der Dichte des Gebiets, unabhängig vom Parameter
- mit
- Query Autocomplete: 50.000 Meter
- Textsuche: 50.000 Meter
Beispiele für Query Autocomplete (Legacy)
URL
https://maps.googleapis.com/maps/api/place/queryautocomplete/json ?input=pizza%20near%20par &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&key=YOUR_API_KEY'Eine Anfrage „Pizza in der Nähe von Par“ mit Ergebnissen auf Französisch:
URL
https://maps.googleapis.com/maps/api/place/queryautocomplete/json ?input=pizza%20near%20par &language=fr &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&language=fr&key=YOUR_API_KEY'Sie müssen den API-Schlüssel in diesen Beispielen durch Ihren eigenen Schlüssel ersetzen.
Antwort für Query Autocomplete (Legacy)
Antworten für die automatische Vervollständigung von Suchanfragen (Legacy) werden in dem Format zurückgegeben, das durch das Flag output im Pfad der URL-Anfrage angegeben wird. Die folgenden Ergebnisse werden für eine Abfrage mit den folgenden Parametern zurückgegeben:
URL
https://maps.googleapis.com/maps/api/place/queryautocomplete/json ?input=pizza%20near%20par &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&key=YOUR_API_KEY'JSON
{ "predictions": [ { "description": "pizza near Paris, France", "matched_substrings": [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }], "structured_formatting": { "main_text": "pizza", "main_text_matched_substrings": [{ "length": 5, "offset": 0 }], "secondary_text": "near Paris, France", "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }], }, "terms": [ { "offset": 0, "value": "pizza" }, { "offset": 6, "value": "near" }, { "offset": 11, "value": "Paris" }, { "offset": 18, "value": "France" }, ], }, { "description": "pizza near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India", "matched_substrings": [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }], "structured_formatting": { "main_text": "pizza", "main_text_matched_substrings": [{ "length": 5, "offset": 0 }], "secondary_text": "near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India", "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }], }, "terms": [ { "offset": 0, "value": "pizza" }, { "offset": 6, "value": "near" }, { "offset": 11, "value": "Pari Chowk" }, { "offset": 23, "value": "NRI City" }, { "offset": 33, "value": "Omega II" }, { "offset": 43, "value": "Noida" }, { "offset": 50, "value": "Uttar Pradesh" }, { "offset": 65, "value": "India" }, ], }, { "description": "pizza near Disneyland Park, Disneyland Drive, Anaheim, CA, USA", "matched_substrings": [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 22 }], "structured_formatting": { "main_text": "pizza", "main_text_matched_substrings": [{ "length": 5, "offset": 0 }], "secondary_text": "near Disneyland Park, Disneyland Drive, Anaheim, CA, USA", "secondary_text_matched_substrings": [{ "length": 3, "offset": 16 }], }, "terms": [ { "offset": 0, "value": "pizza" }, { "offset": 6, "value": "near" }, { "offset": 11, "value": "Disneyland Park" }, { "offset": 28, "value": "Disneyland Drive" }, { "offset": 46, "value": "Anaheim" }, { "offset": 55, "value": "CA" }, { "offset": 59, "value": "USA" }, ], }, { "description": "pizza near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France", "matched_substrings": [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 36 }], "structured_formatting": { "main_text": "pizza", "main_text_matched_substrings": [{ "length": 5, "offset": 0 }], "secondary_text": "near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France", "secondary_text_matched_substrings": [{ "length": 3, "offset": 30 }], }, "terms": [ { "offset": 0, "value": "pizza" }, { "offset": 6, "value": "near" }, { "offset": 11, "value": "Cathédrale Notre-Dame de Paris" }, { "offset": 43, "value": "Parvis Notre-Dame - place Jean-Paul-II" }, { "offset": 83, "value": "Paris" }, { "offset": 90, "value": "France" }, ], }, { "description": "pizza near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France", "matched_substrings": [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }], "structured_formatting": { "main_text": "pizza", "main_text_matched_substrings": [{ "length": 5, "offset": 0 }], "secondary_text": "near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France", "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }], }, "terms": [ { "offset": 0, "value": "pizza" }, { "offset": 6, "value": "near" }, { "offset": 11, "value": "Paris Beauvais Airport" }, { "offset": 35, "value": "Route de l'Aéroport" }, { "offset": 56, "value": "Tillé" }, { "offset": 63, "value": "France" }, ], }, ], "status": "OK", }
XML
<AutocompletionResponse> <status>OK</status> <prediction> <description>pizza near Paris, France</description> <term> <value>pizza</value> <offset>0</offset> </term> <term> <value>near</value> <offset>6</offset> </term> <term> <value>Paris</value> <offset>11</offset> </term> <term> <value>France</value> <offset>18</offset> </term> <matched_substring> <offset>0</offset> <length>5</length> </matched_substring> <matched_substring> <offset>11</offset> <length>3</length> </matched_substring> <structured_formatting> <description>pizza</description> <subdescription>near Paris, France</subdescription> <description_matched_substring> <offset>0</offset> <length>5</length> </description_matched_substring> <subdescription_matched_substring> <offset>5</offset> <length>3</length> </subdescription_matched_substring> </structured_formatting> </prediction> <prediction> <description>pizza near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India</description> <term> <value>pizza</value> <offset>0</offset> </term> <term> <value>near</value> <offset>6</offset> </term> <term> <value>Pari Chowk</value> <offset>11</offset> </term> <term> <value>NRI City</value> <offset>23</offset> </term> <term> <value>Omega II</value> <offset>33</offset> </term> <term> <value>Noida</value> <offset>43</offset> </term> <term> <value>Uttar Pradesh</value> <offset>50</offset> </term> <term> <value>India</value> <offset>65</offset> </term> <matched_substring> <offset>0</offset> <length>5</length> </matched_substring> <matched_substring> <offset>11</offset> <length>3</length> </matched_substring> <structured_formatting> <description>pizza</description> <subdescription>near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India</subdescription> <description_matched_substring> <offset>0</offset> <length>5</length> </description_matched_substring> <subdescription_matched_substring> <offset>5</offset> <length>3</length> </subdescription_matched_substring> </structured_formatting> </prediction> <prediction> <description>pizza near Disneyland Park, Disneyland Drive, Anaheim, CA, USA</description> <term> <value>pizza</value> <offset>0</offset> </term> <term> <value>near</value> <offset>6</offset> </term> <term> <value>Disneyland Park</value> <offset>11</offset> </term> <term> <value>Disneyland Drive</value> <offset>28</offset> </term> <term> <value>Anaheim</value> <offset>46</offset> </term> <term> <value>CA</value> <offset>55</offset> </term> <term> <value>USA</value> <offset>59</offset> </term> <matched_substring> <offset>0</offset> <length>5</length> </matched_substring> <matched_substring> <offset>22</offset> <length>3</length> </matched_substring> <structured_formatting> <description>pizza</description> <subdescription>near Disneyland Park, Disneyland Drive, Anaheim, CA, USA</subdescription> <description_matched_substring> <offset>0</offset> <length>5</length> </description_matched_substring> <subdescription_matched_substring> <offset>16</offset> <length>3</length> </subdescription_matched_substring> </structured_formatting> </prediction> <prediction> <description>pizza near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France</description> <term> <value>pizza</value> <offset>0</offset> </term> <term> <value>near</value> <offset>6</offset> </term> <term> <value>Cathédrale Notre-Dame de Paris</value> <offset>11</offset> </term> <term> <value>Parvis Notre-Dame - place Jean-Paul-II</value> <offset>43</offset> </term> <term> <value>Paris</value> <offset>83</offset> </term> <term> <value>France</value> <offset>90</offset> </term> <matched_substring> <offset>0</offset> <length>5</length> </matched_substring> <matched_substring> <offset>36</offset> <length>3</length> </matched_substring> <structured_formatting> <description>pizza</description> <subdescription>near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France</subdescription> <description_matched_substring> <offset>0</offset> <length>5</length> </description_matched_substring> <subdescription_matched_substring> <offset>30</offset> <length>3</length> </subdescription_matched_substring> </structured_formatting> </prediction> <prediction> <description>pizza near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France</description> <term> <value>pizza</value> <offset>0</offset> </term> <term> <value>near</value> <offset>6</offset> </term> <term> <value>Paris Beauvais Airport</value> <offset>11</offset> </term> <term> <value>Route de l'Aéroport</value> <offset>35</offset> </term> <term> <value>Tillé</value> <offset>56</offset> </term> <term> <value>France</value> <offset>63</offset> </term> <matched_substring> <offset>0</offset> <length>5</length> </matched_substring> <matched_substring> <offset>11</offset> <length>3</length> </matched_substring> <structured_formatting> <description>pizza</description> <subdescription>near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France</subdescription> <description_matched_substring> <offset>0</offset> <length>5</length> </description_matched_substring> <subdescription_matched_substring> <offset>5</offset> <length>3</length> </subdescription_matched_substring> </structured_formatting> </prediction> </AutocompletionResponse>
Wenn der Places-Dienst JSON-Ergebnisse für eine Suche zurückgibt, werden diese in einem predictions-Array platziert. Auch wenn der Dienst keine Ergebnisse zurückgibt (z. B. wenn sich die location an einem abgelegenen Ort befindet), wird ein leeres predictions-Array zurückgegeben. XML-Antworten bestehen aus null oder mehr <prediction>-Elementen.
PlacesQueryAutocompleteResponse
| Feld | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
|
required | Array<PlaceAutocompletePrediction> |
Enthält ein Array von Vorhersagen. Weitere Informationen finden Sie unter PlaceAutocompletePrediction. |
|
required | PlacesAutocompleteStatus |
Enthält den Status der Anfrage und möglicherweise Debugging-Informationen, mit deren Hilfe Sie herausfinden können, warum die Anfrage fehlgeschlagen ist. Weitere Informationen finden Sie unter PlacesAutocompleteStatus. |
|
optional | String |
Wenn der Dienst einen anderen Statuscode als |
|
optional | Array<string> |
Wenn der Dienst zusätzliche Informationen zur Anfragespezifikation zurückgibt, kann im Antwortobjekt ein zusätzliches |
PlacesAutocompleteStatus
Statuscodes, die vom Dienst zurückgegeben werden.
OK: Die API-Anfrage war erfolgreich.-
ZERO_RESULTSgibt an, dass die Suche erfolgreich war, aber keine Ergebnisse zurückgegeben wurden. Dieser Fehler kann auftreten, wenn bei der Suche Grenzen an einem abgelegenen Ort übergeben wurden. -
INVALID_REQUEST: Die API-Anfrage war fehlerhaft, in der Regel aufgrund des fehlenden Parametersinput. -
OVER_QUERY_LIMIT, die Folgendes angibt:- Sie haben die Limits für die maximal zulässige Anzahl von Abfragen pro Sekunde überschritten.
- Die Abrechnung wurde für Ihr Konto nicht aktiviert.
- Das monatliche Guthaben von 200 $oder das von Ihnen festgelegte Nutzungslimit wurde überschritten.
- Die angegebene Zahlungsmethode ist nicht mehr gültig. Das kann z. B. bei einer abgelaufenen Kreditkarte der Fall sein.
-
REQUEST_DENIEDgibt an, dass Ihre Anfrage abgelehnt wurde. Das liegt in der Regel daran, dass:- In der Anfrage fehlt ein API-Schlüssel.
- Der Parameter
keyist ungültig.
UNKNOWN_ERROR: Ein unbekannter Fehler ist aufgetreten.
Wenn der Places-Dienst JSON-Ergebnisse für eine Suche zurückgibt, werden diese in einem predictions-Array platziert. Auch wenn der Dienst keine Ergebnisse zurückgibt (z. B. wenn location remote ist), wird trotzdem ein leeres predictions-Array zurückgegeben. XML-Antworten bestehen aus null oder mehr <prediction>-Elementen.
PlaceAutocompletePrediction
| Feld | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
|
erforderlich | String |
Enthält den für Menschen lesbaren Namen für das zurückgegebene Ergebnis. Bei |
|
required | Array<PlaceAutocompleteMatchedSubstring> |
Eine Liste von Teilstrings, die die Position des eingegebenen Begriffs im Vorhersageergebnistext beschreiben, sodass der Begriff bei Bedarf hervorgehoben werden kann. Weitere Informationen finden Sie unter PlaceAutocompleteMatchedSubstring. |
|
required | PlaceAutocompleteStructuredFormat |
Stellt vorformatierten Text bereit, der in den Ergebnissen der automatischen Vervollständigung angezeigt werden kann. Dieser Inhalt ist so zu lesen, wie er ist. Die formatierte Adresse darf nicht programmatisch geparst werden. Weitere Informationen finden Sie unter PlaceAutocompleteStructuredFormat. |
|
required | Array<PlaceAutocompleteTerm> |
Enthält ein Array von Begriffen, die die einzelnen Abschnitte der zurückgegebenen Beschreibung identifizieren. Ein Abschnitt der Beschreibung wird in der Regel mit einem Komma abgeschlossen. Jeder Eintrag im Array hat ein Feld Weitere Informationen finden Sie unter PlaceAutocompleteTerm. |
|
optional | integer |
Die Luftlinie in Metern vom Ursprung. Dieses Feld wird nur für Anfragen zurückgegeben, die mit einem |
|
optional | String |
Eine ID in Textform, die einen Ort eindeutig bezeichnet. Wenn Sie Informationen zum Ort abrufen möchten, geben Sie diese ID im Feld „placeId“ einer Places API-Anfrage weiter. Weitere Informationen zu Orts-IDs finden Sie in der Übersicht zu Orts-IDs. |
|
optional | String |
Weitere Informationen finden Sie unter place_id. |
|
optional | Array<string> |
Enthält ein Array von Typen, die für diesen Ort gelten. Beispiel:
|
PlaceAutocompleteMatchedSubstring
| Feld | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
|
erforderlich | Zahl |
Länge des übereinstimmenden Teilstrings im Vorhersageergebnistext. |
|
required | Zahl |
Startposition des übereinstimmenden Teilstrings im Text des Vorhersageergebnisses. |
PlaceAutocompleteStructuredFormat
| Feld | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
|
erforderlich | String |
Enthält den Haupttext einer Vorhersage, in der Regel den Namen des Orts. |
|
required | Array<PlaceAutocompleteMatchedSubstring> |
Enthält ein Array mit dem Wert Weitere Informationen finden Sie unter PlaceAutocompleteMatchedSubstring. |
|
optional | String |
Enthält den sekundären Text einer Vorhersage, in der Regel den Standort des Orts. |
|
optional | Array<PlaceAutocompleteMatchedSubstring> |
Enthält ein Array mit dem Wert Weitere Informationen finden Sie unter PlaceAutocompleteMatchedSubstring. |
PlaceAutocompleteTerm
| Feld | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
|
erforderlich | Zahl |
Definiert die Startposition dieses Begriffs in der Beschreibung, gemessen in Unicode-Zeichen. |
|
required | String |
Der Text des Begriffs. |