Find Place (starsza wersja)

Żądanie Find Place (starsza wersja) przyjmuje tekstowe dane wejściowe i zwraca miejsce. Dane wejściowe mogą być dowolnymi danymi tekstowymi dotyczącymi miejsc, takimi jak nazwa, adres lub numer telefonu. Żądanie musi być ciągiem znaków. Żądanie Find Place (Legacy) używające danych innych niż ciąg znaków, takich jak współrzędne szerokości i długości geograficznej lub Plus Code, generuje błąd.

Żądania Find Place (starsza wersja)

Żądanie Find Place (Legacy) to adres URL HTTP w tym formacie:

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

gdzie output może być jedną z tych wartości:

• json (zalecane) wskazuje dane wyjściowe w formacie JSON (JavaScript Object Notation).
• xml wskazuje dane wyjściowe w formacie XML.

Do zainicjowania żądania Find Place (Legacy) wymagane są określone parametry. Zgodnie ze standardem adresów URL wszystkie parametry są oddzielone znakiem ampersand (&).

Wymagane parametry

• wprowadzanie danych

  Ciąg tekstowy, który ma zostać wyszukany. Musi to być nazwa miejsca, adres lub numer telefonu (np. „ul. Główna 123” lub „Urząd Miasta”).

• inputtype

  Typ danych wejściowych. Może to być textquery lub phonenumber. Numery telefonów muszą być w formacie międzynarodowym (ze znakiem plusa „+” na początku, po którym następuje kod kraju, a następnie numer telefonu). Więcej informacji znajdziesz w zaleceniach ITU E.164.

Parametry opcjonalne

• pól,

  Uwaga: żądania wyszukiwania miejsc (starsza wersja) i żądania informacji o miejscu (starsza wersja) nie zwracają tych samych pól. Żądania wyszukiwania miejsc (starsza wersja) zwracają podzbiór pól zwracanych przez żądania informacji o miejscu (starsza wersja). Jeśli wyszukiwanie miejsc (starsza wersja) nie zwraca pola, którego potrzebujesz, możesz użyć wyszukiwania miejsc (starsza wersja), aby uzyskać place_id, a następnie użyć tego identyfikatora miejsca do wysłania żądania informacji o miejscu (starsza wersja). Więcej informacji o polach, które są niedostępne w żądaniu wyszukiwania miejsc (starsza wersja), znajdziesz w artykule o obsłudze pól Places API.

  Użyj parametru fields, aby określić rozdzielaną przecinkami listę typów danych o miejscu, które mają zostać zwrócone. Na przykład: fields=formatted_address,name,geometry. Podczas określania wartości złożonych używaj ukośnika. Na przykład: opening_hours/open_now.

  Pola są podzielone na 3 kategorie rozliczeniowe: Podstawowe, Kontakt i Atmosfera. Pola podstawowe są rozliczane według stawki podstawowej, a pola Kontakt i Atmosfera według wyższej stawki. SKU Podstawowe, Kontakt i Atmosfera są rozliczane dodatkowo do SKU podstawowego (Szczegóły miejsca, Znajdź miejsce, Wyszukiwanie w pobliżu lub Wyszukiwanie tekstowe) w przypadku żądania, które je wywołało. Więcej informacji znajdziesz w arkuszu cen.

  Podstawowe

  Kategoria Podstawowe obejmuje te pola: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (wycofane), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

  Kontakt

  Kategoria Kontakt obejmuje te pola: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website.

  Atmosfera

  Kategoria Atmosfera obejmuje te pola: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

  Uwaga: atrybucje (html_attributions) są zawsze zwracane przy każdym wywołaniu, niezależnie od tego, czy żądano tego pola.

• 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 nie podasz parametru language, interfejs API spróbuje użyć preferowanego języka określonego w nagłówku Accept-Language.
  • Interfejs API stara się podać adres, który jest czytelny zarówno dla użytkownika, jak i dla mieszkańców. Aby osiągnąć ten cel, zwraca adresy pocztowe w języku lokalnym, w razie potrzeby transliterowane na pismo czytelne dla użytkownika, z uwzględnieniem preferowanego języka. Wszystkie inne 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żywa najbliższego dopasowania.
  • Preferowany język ma niewielki wpływ na zestaw wyników, które interfejs API zwraca, oraz na kolejność, w jakiej są 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.

• locationbias

  Preferuj wyniki w określonym obszarze, podając promień i szerokość/długość geograficzną lub 2 pary szerokości/długości geograficznej reprezentujące punkty prostokąta. Jeśli ten parametr nie zostanie określony, interfejs API domyślnie użyje dopasowywania na podstawie adresu IP.

  • IP bias: instruuje interfejs API, aby używał kierowania na adres IP. Przekaż ciąg tekstowy ipbias (ta opcja nie ma dodatkowych parametrów).
  • Okrąg: ciąg znaków określający promień w metrach oraz szerokość i długość geograficzną w stopniach dziesiętnych. Użyj tego formatu: circle:radius@lat,lng.
  • Prostokątny: ciąg znaków określający 2 pary współrzędnych geograficznych w stopniach dziesiętnych, reprezentujące południowo-zachodni i północno-wschodni punkt prostokąta. Użyj tego formatu:rectangle:south,west|north,east. Pamiętaj, że wartości wschód/zachód są zawijane do zakresu -180, 180, a wartości północ/południe są ograniczane do zakresu -90, 90.

Przykłady Find Place (starsza wersja)

Poniższy przykład pokazuje żądanie Find Place (starsza wersja) dotyczące „Museum of Contemporary Art Australia”, w tym pola photos, formatted_address, name, rating, opening_hours i geometry:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

Poniższy przykład pokazuje żądanie Find Place (starsza wersja) dotyczące „Mongolian Grill” z parametrem locationbias, który preferuje wyniki w promieniu 2000 metrów od określonych współrzędnych:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

Poniższy przykład pokazuje żądanie Find Place (Legacy) dotyczące numeru telefonu. Zwróć uwagę, że prefiks połączenia międzynarodowego „+” został zakodowany jako %2B, dzięki czemu żądanie jest zgodnym adresem URL. Jeśli nie zostanie zakodowany, prefiks + zostanie zdekodowany na serwerze jako spacja, co spowoduje nieprawidłowe wyszukiwanie numeru telefonu.

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Odpowiedzi Find Place (Legacy)

Odpowiedź Find Place (starsza wersja) zawiera tylko typy danych określone za pomocą parametru fields oraz html_attributions. Poniższy przykład pokazuje odpowiedź na żądanie Find Place (starsza wersja) dotyczące „Museum of Contemporary Art Australia”, w tym pola formatted_address, geometry, name, opening_hours, photos, rating.

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}    

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

    

PlacesFindPlaceFromTextResponse

PlacesSearchStatus

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 do wyszukiwania przekazano latlng w zdalnej lokalizacji.
• INVALID_REQUEST, co oznacza, że żądanie do interfejsu API było nieprawidłowe, zwykle z powodu braku wymaganego parametru zapytania (location lub radius).
• OVER_QUERY_LIMIT, który zawiera dowolną z tych informacji:
  • Przekroczono limity zapytań na sekundę.
  • Na Twoim koncie nie włączono płatności.
  • Przekroczono miesięczny limit środków w wysokości 200 USD lub samodzielnie nałożony limit wykorzystania.
  • Podana forma płatności nie jest już ważna (np. karta kredytowa straciła ważność).
  Więcej informacji o tym, jak rozwiązać ten problem, znajdziesz w najczęstszych pytaniach dotyczących Map.
• REQUEST_DENIED z informacją, że Twoja prośba została odrzucona. Zwykle dzieje się tak, ponieważ:
  • W żądaniu brakuje klucza interfejsu API.
  • Parametr key jest nieprawidłowy.
• UNKNOWN_ERROR wskazujący nieznany błąd.

Miejsce

Odpowiedzi wyszukiwania miejsc zwracają ten podzbiór pól Place. Nie wszystkie atrybuty są dostępne dla wszystkich typów miejsc. Aby pobrać pola, których nie zwraca wyszukiwanie miejsc, takie jak address_components, formatted_phone_number, reviews lub website, przekaż zwrócony parametr place_id w żądaniu informacji o miejscu (starsza wersja). Informacje o dostępności pól i poziomach cenowych w przypadku różnych punktów końcowych znajdziesz w artykule Pola danych miejsc (starsza wersja).