Ta usługa lub funkcja ma stan „Stara”. Więcej informacji o stanie „Stary” znajdziesz w artykule Starsze usługi i funkcje. Aby przejść na interfejs Places API (nowy), przeczytaj przewodnik po migracji.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Zapytanie autouzupełniania (starsza wersja)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Uwaga: biblioteki po stronie serwera i po stronie klienta

Interfejs Places API jest też dostępny w klientach Java, Python, Go i Node.js dla usług Map Google. Interfejs Places API i biblioteki klienta są przeznaczone do użytku w aplikacjach serwerowych.

Jeśli tworzysz aplikację po stronie klienta, zapoznaj się z Places SDK na Androida (nowy), Places SDK na iOS (nowy) i biblioteką Miejsc w Maps JavaScript API.

Autouzupełnianie zapytań (starsza wersja) może służyć do podawania prognozy zapytania w przypadku wyszukiwań geograficznych opartych na tekście, zwracając sugerowane zapytania podczas wpisywania.

Żądania autouzupełniania zapytań (starsza wersja)

Autouzupełnianie zapytań (starsza wersja) jest częścią interfejsu Places API (starsza wersja) i ma wspólny klucz interfejsu API oraz limit z interfejsem Places API (starsza wersja).

Interfejs Query Autocomplete (Legacy) umożliwia dodawanie do aplikacji podpowiedzi geograficznych zapytań w czasie rzeczywistym. Zamiast wyszukiwać konkretną lokalizację, użytkownik może wpisać wyszukiwanie według kategorii, np. „pizza w pobliżu Nowego Jorku”, a usługa odpowie listą sugerowanych zapytań pasujących do ciągu znaków. Usługa autouzupełniania zapytań (starsza wersja) może dopasowywać zarówno całe słowa, jak i podciągi znaków, więc aplikacje mogą wysyłać zapytania podczas wpisywania przez użytkownika, aby wyświetlać podpowiedzi na bieżąco.

Żądanie autouzupełniania zapytań (starsza wersja) to adres URL HTTP w tym formacie:

https://maps.googleapis.com/maps/api/place/queryautocomplete/output?parameters

gdzie output może być json lub xml.

Do zainicjowania żądania automatycznego uzupełniania zapytań (starsza wersja) wymagane są określone parametry. Zgodnie ze standardem adresów URL wszystkie parametry są rozdzielone znakiem ampersand (&). Poniżej znajdziesz listę parametrów i ich możliwych wartości.

Wymagane parametry

wprowadzanie

Ciąg tekstowy, w którym ma zostać przeprowadzone wyszukiwanie. Usługa autouzupełniania miejsc zwróci pasujące kandydatury na podstawie tego ciągu znaków i uporządkuje wyniki według ich postrzeganej trafności.

Parametry opcjonalne

language

Język, w którym mają być zwracane wyniki.
- Zobacz listę obsługiwanych języków. Google często aktualizuje listę obsługiwanych języków, więc może ona nie być kompletna.
- Jeśli parametr language nie zostanie podany, interfejs API spróbuje użyć preferowanego języka określonego w nagłówku Accept-Language.
- Interfejs API stara się podać adres ulicy, który jest czytelny zarówno dla użytkownika, jak i mieszkańców. Aby to osiągnąć, zwraca adresy w języku lokalnym, w razie potrzeby transliterowane na pismo czytelne dla użytkownika, z uwzględnieniem preferowanego języka. Wszystkie pozostałe adresy są zwracane w preferowanym języku. Wszystkie komponenty adresu są zwracane w tym samym języku, który jest wybierany na podstawie pierwszego komponentu.
- Jeśli nazwa nie jest dostępna w preferowanym języku, interfejs API użyje najbliższego dopasowania.
- Preferowany język ma niewielki wpływ na zestaw wyników, które interfejs API wybiera do zwrócenia, oraz na kolejność, w jakiej są one zwracane. Geokoder interpretuje skróty w różny sposób w zależności od języka, np. skróty typów ulic lub synonimy, które mogą być prawidłowe w jednym języku, ale nie w innym. Na przykład utca i tér to synonimy słowa „ulica” w języku węgierskim.
lokalizacja

Określa punkt, jako współrzędne latitude,longitude, wokół którego ma się odbywać wyszukiwanie. Usługa Miejsca korzysta z lokalizacji, aby dostosować wyszukiwanie i wyświetlać wyniki w obszarze określonym przez parametry location i radius. Wyniki spoza tego obszaru mogą być nadal wyświetlane.

Parametr location może zostać zastąpiony, jeśli element query zawiera wyraźną lokalizację, np. Market in Barcelona. Użycie cudzysłowu wokół zapytania może też wpłynąć na wagę przypisaną do location i radius.
odliczyć

Pozycja ostatniego znaku w wyrażeniu wejściowym, którego usługa używa do dopasowywania prognoz. Jeśli na przykład dane wejściowe to Google, a przesunięcie wynosi 3, usługa dopasuje Goo. Ciąg znaków określony przez przesunięcie jest dopasowywany tylko do pierwszego słowa w terminie wejściowym. Jeśli na przykład termin wejściowy to Google abc, a przesunięcie wynosi 3, usługa spróbuje dopasować go do Goo abc. Jeśli nie podasz przesunięcia, usługa wykorzysta cały okres. Przesunięcie powinno być zwykle ustawione na pozycję kursora tekstowego.
promień

Określa odległość (w metrach), w której mają być zwracane wyniki dotyczące miejsc. Możesz zawęzić wyniki do określonego okręgu, przekazując parametr location i radius. W ten sposób instruujesz usługę Miejsca, aby preferowała wyświetlanie wyników w obrębie tego okręgu. Wyniki spoza zdefiniowanego obszaru mogą być nadal wyświetlane.

Promień zostanie automatycznie ograniczony do maksymalnej wartości w zależności od typu wyszukiwania i innych parametrów.
- Autouzupełnianie: 50 000 metrów
- Wyszukiwanie w pobliżu:
  - z keyword lub name: 50 000 metrów
  - bez keyword lub name
    - Do 50 000 m, dostosowywane dynamicznie na podstawie gęstości obszaru, niezależnie od parametru rankby.
    - Jeśli używasz wartości rankby=distance, parametr promienia nie zostanie zaakceptowany i spowoduje wystąpienie błędu INVALID_REQUEST.
- Autouzupełnianie zapytań: 50 000 metrów
- Wyszukiwanie tekstu: 50 000 metrów

Przykłady autouzupełniania zapytań (starsza wersja)

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'

Zapytanie „Pizza w pobliżu Par” z wynikami w języku francuskim:

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'

Pamiętaj, że w tych przykładach musisz zastąpić klucz interfejsu API swoim kluczem.

Odpowiedź Query Autocomplete (starsza wersja)

Odpowiedzi dotyczące automatycznego uzupełniania zapytań (starsza wersja) są zwracane w formacie wskazanym przez flagę output w ścieżce żądania URL. Poniższe wyniki zostały zwrócone w odpowiedzi na zapytanie z tymi parametrami:

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>

Gdy usługa Miejsca zwraca wyniki wyszukiwania w formacie JSON, umieszcza je w tablicy predictions. Nawet jeśli usługa nie zwróci żadnych wyników (np. gdy location jest zdalny), nadal zwraca pustą tablicę predictions. Odpowiedzi XML składają się z co najmniej 1 elementu <prediction>.

PlacesQueryAutocompleteResponse

Pole	Wymagane	Typ	Opis
`predictions`	wymagane	Array<PlaceAutocompletePrediction>	Zawiera tablicę prognoz. Więcej informacji znajdziesz w artykule PlaceAutocompletePrediction.
`status`	wymagane	PlacesAutocompleteStatus	Zawiera stan żądania i może zawierać informacje do debugowania, które pomogą Ci ustalić, dlaczego żądanie nie powiodło się. Więcej informacji znajdziesz w sekcji PlacesAutocompleteStatus.
`error_message`	opcjonalnie	ciąg znaków	Jeśli usługa zwróci kod stanu inny niż `OK`, w obiekcie odpowiedzi może się pojawić dodatkowe pole `error_message`. To pole zawiera bardziej szczegółowe informacje o przyczynach danego kodu stanu. To pole nie jest zawsze zwracane, a jego zawartość może ulec zmianie.
`info_messages`	opcjonalnie	Array<string>	Gdy usługa zwraca dodatkowe informacje o specyfikacji żądania, w obiekcie odpowiedzi może się pojawić dodatkowe pole `info_messages`. To pole jest zwracane tylko w przypadku żądań zakończonych powodzeniem. Może nie zawsze być zwracany, a jego zawartość może ulec zmianie.

PlacesAutocompleteStatus

Kody stanu zwracane przez usługę.

OK, co oznacza, że żądanie do interfejsu API zostało zrealizowane.
ZERO_RESULTS, co oznacza, że wyszukiwanie zakończyło się powodzeniem, ale nie zwróciło żadnych wyników. Może się tak zdarzyć, jeśli wyszukiwanie zostało przekazane do granic w odległej lokalizacji.
INVALID_REQUEST, co oznacza, że żądanie do interfejsu API było nieprawidłowo sformułowane, zwykle z powodu braku parametru input.
OVER_QUERY_LIMIT – oznacza dowolną z tych sytuacji:
- Przekroczono limity zapytań.
- Na Twoim koncie nie włączono płatności.
- Przekroczono miesięczne środki w wysokości 200 USD lub samodzielnie ustalony limit wykorzystania.
- Podana forma płatności nie jest już ważna (np. karta kredytowa straciła ważność).
Więcej informacji o rozwiązywaniu tego problemu znajdziesz w najczęstszych pytaniach dotyczących Map.
REQUEST_DENIED informujący o odrzuceniu Twojej prośby, zwykle z tych powodów:
- W żądaniu brakuje klucza interfejsu API.
- Parametr key jest nieprawidłowy.
UNKNOWN_ERROR – nieznany błąd.

Gdy usługa Miejsca zwraca wyniki wyszukiwania w formacie JSON, umieszcza je w tablicy predictions. Nawet jeśli usługa nie zwraca żadnych wyników (np. gdy location jest zdalny), nadal zwraca pustą tablicę predictions. Odpowiedzi XML składają się z 0 lub większej liczby elementów <prediction>.

PlaceAutocompletePrediction

Pole	Wymagane	Typ	Opis
`description`	wymagane	ciąg znaków	Zawiera zrozumiałą dla człowieka nazwę zwróconego wyniku. W przypadku wyników `establishment` jest to zwykle nazwa firmy. Te treści należy odczytywać w takiej postaci, w jakiej są wyświetlane. Nie analizuj programowo sformatowanego adresu.
`matched_substrings`	wymagane	Tablica<PlaceAutocompleteMatchedSubstring>	Lista podciągów opisujących lokalizację wpisanego terminu w tekście wyniku prognozy, dzięki czemu w razie potrzeby można go wyróżnić. Więcej informacji znajdziesz w sekcji PlaceAutocompleteMatchedSubstring.
`structured_formatting`	wymagane	PlaceAutocompleteStructuredFormat	Zawiera wstępnie sformatowany tekst, który może być wyświetlany w wynikach autouzupełniania. Te treści należy odczytywać w takiej postaci, w jakiej są wyświetlane. Nie analizuj programowo sformatowanego adresu. Więcej informacji znajdziesz w artykule PlaceAutocompleteStructuredFormat.
`terms`	wymagane	Tablica<PlaceAutocompleteTerm>	Zawiera tablicę terminów identyfikujących poszczególne sekcje zwróconego opisu (sekcja opisu jest zwykle zakończona przecinkiem). Każdy wpis w tablicy ma pole `value` zawierające tekst terminu i pole `offset` określające pozycję początkową tego terminu w opisie (w znakach Unicode). Więcej informacji znajdziesz w sekcji PlaceAutocompleteTerm.
`distance_meters`	opcjonalnie	liczba całkowita	Odległość w metrach w linii prostej od punktu początkowego. To pole jest zwracane tylko w przypadku żądań wysłanych za pomocą `origin`.
`place_id`	opcjonalnie	ciąg znaków	Identyfikator tekstowy, który jednoznacznie identyfikuje miejsce. Aby pobrać informacje o miejscu, przekaż ten identyfikator w polu placeId żądania do interfejsu Places API. Więcej informacji o identyfikatorach miejsc znajdziesz w omówieniu identyfikatorów miejsc.
`reference`	opcjonalnie	ciąg znaków	`reference` zostało wycofane. Zobacz place_id.
`types`	opcjonalnie	Array<string>	Zawiera tablicę typów, które mają zastosowanie do tego miejsca. Na przykład:`[ "political", "locality" ]` lub `[ "establishment", "geocode", "beauty_salon" ]`. Tablica może zawierać wiele wartości. Dowiedz się więcej o typach miejsc.

PlaceAutocompleteMatchedSubstring

Pole	Wymagane	Typ	Opis
`length`	wymagane	liczba	Długość pasującego podciągu w tekście wyniku prognozy.
`offset`	wymagane	liczba	Lokalizacja początkowa pasującego podciągu w tekście wyniku prognozy.

PlaceAutocompleteStructuredFormat

Pole	Wymagane	Typ	Opis
`main_text`	wymagane	ciąg znaków	Zawiera główny tekst prognozy, zwykle nazwę miejsca.
`main_text_matched_substrings`	wymagane	Tablica<PlaceAutocompleteMatchedSubstring>	Zawiera tablicę z wartością `offset` i `length`. Opisują one położenie wpisanego terminu w tekście wyniku prognozy, dzięki czemu można go w razie potrzeby wyróżnić. Więcej informacji znajdziesz w sekcji PlaceAutocompleteMatchedSubstring.
`secondary_text`	opcjonalnie	ciąg znaków	Zawiera tekst dodatkowy prognozy, zwykle lokalizację miejsca.
`secondary_text_matched_substrings`	opcjonalnie	Tablica<PlaceAutocompleteMatchedSubstring>	Zawiera tablicę z wartością `offset` i `length`. Opisują one położenie wpisanego terminu w tekście wyniku prognozy, dzięki czemu można go w razie potrzeby wyróżnić. Więcej informacji znajdziesz w sekcji PlaceAutocompleteMatchedSubstring.

PlaceAutocompleteTerm

Pole	Wymagane	Typ	Opis
`offset`	wymagane	liczba	Określa pozycję początkową tego terminu w opisie, mierzoną w znakach Unicode.
`value`	wymagane	ciąg znaków	Tekst terminu.

Zapytanie autouzupełniania (starsza wersja) Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Żądania autouzupełniania zapytań (starsza wersja)

Wymagane parametry

wprowadzanie

Parametry opcjonalne

language

lokalizacja

odliczyć

promień

Przykłady autouzupełniania zapytań (starsza wersja)

URL

curl

URL

curl

Odpowiedź Query Autocomplete (starsza wersja)

URL

curl

JSON

XML

PlacesQueryAutocompleteResponse

predictions

status

error_message

info_messages

PlacesAutocompleteStatus

PlaceAutocompletePrediction

description

matched_substrings

structured_formatting

terms

distance_meters

place_id

reference

types

PlaceAutocompleteMatchedSubstring

length

offset

PlaceAutocompleteStructuredFormat

main_text

main_text_matched_substrings

secondary_text

secondary_text_matched_substrings

PlaceAutocompleteTerm

offset

value

Zapytanie autouzupełniania (starsza wersja)

`predictions`

`status`

`error_message`

`info_messages`

`description`

`matched_substrings`

`structured_formatting`

`terms`

`distance_meters`

`place_id`

`reference`

`types`

`length`

`offset`

`main_text`

`main_text_matched_substrings`

`secondary_text`

`secondary_text_matched_substrings`

`offset`

`value`