Find Place (starsza wersja)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Żądanie Znajdź miejsce (starsza wersja) przyjmuje tekst jako dane wejściowe i zwraca miejsce. Dane wejściowe mogą być dowolnymi danymi tekstowymi Miejsc, takimi jak nazwa, adres lub numer telefonu. Żądanie musi być ciągiem znaków. Żądanie Find Place (Legacy) z użyciem danych innych niż ciągi znaków, takich jak współrzędne geograficzne lub kod plus, generuje błąd.

Żądania Find Place (starsza wersja)

Żądanie Znajdź miejsce (starsza wersja) to adres URL HTTP w tym formacie:

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

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

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

Aby zainicjować żądanie Znajdź miejsce (starsza wersja), musisz podać określone parametry. Zgodnie ze standardem adresów URL wszystkie parametry są rozdzielane znakiem ampersand (&).

Wymagane parametry

  • wprowadzanie danych

    Ciąg tekstowy, w którym chcesz wyszukać informacje, np. „restauracja” lub „ulica Główna 123”. Musi to być nazwa miejsca, adres lub kategoria placówek. Inne typy danych wejściowych mogą generować błędy i nie gwarantują zwrócenia prawidłowych wyników. Interfejs Places API zwróci pasujące kandydatury na podstawie tego ciągu znaków i uporządkuje wyniki według ich postrzeganej trafności.

  • inputtype

    Typ danych wejściowych. Może to być textquery lub phonenumber. Numery telefonów muszą być podane w formacie międzynarodowym (z prefixem w postaci znaku plusa „+”, po którym następuje kod kraju, a potem sam numer telefonu). Więcej informacji znajdziesz w rekomendacji E.164 ITU.

Parametry opcjonalne

  • pola

    Uwaga: żądania wyszukiwania miejsc i żądania informacji o miejscu nie zwracają tych samych pól. Żądania wyszukiwania miejsc zwracają podzbiór pól, które są zwracane przez żądania informacji o miejscu. Jeśli w wynikach wyszukiwania miejsc nie ma pola, którego potrzebujesz, możesz użyć wyszukiwania miejsc, aby uzyskać place_id, a potem użyć tego identyfikatora miejsca do wysłania żądania informacji o miejscu. Więcej informacji o polach niedostępnych w żądaniu wyszukiwania miejsc znajdziesz w Places API fields support.

    Użyj parametru fields, aby określić listę oddzielonych przecinkami 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. Za pola podstawowe naliczana jest stawka podstawowa, a za pola Kontakt i Atmosfera – wyższa stawka. SKU Basic, Contact i Atmosphere są naliczane dodatkowo do podstawowego SKU (informacje o miejscu, Find Place, Wyszukiwanie w pobliżu lub Wyszukaj tekst) w przypadku żądania, które je wywołało. Więcej informacji znajdziesz w arkuszu cen.

    Basic

    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 zawiera 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 w każdym wywołaniu, niezależnie od tego, czy pole zostało wysłane w żądaniu.

  • 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, a w razie potrzeby transliteruje je na pismo czytelne dla użytkownika, uwzględniając preferowany język. 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.

  • locationbias

    Preferuj wyniki w określonym obszarze, podając promień i współrzędne geograficzne lub 2 pary współrzędnych geograficznych reprezentujące punkty prostokąta. Jeśli ten parametr nie zostanie określony, interfejs API domyślnie używa preferowania adresu IP.

    • IP bias: instruuje interfejs API, aby używał odchylenia adresu IP. Przekaż ciąg znaków 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ąt: ciąg znaków określający 2 pary współrzędnych geograficznych w stopniach dziesiętnych, reprezentujące punkty południowo-zachodni i północno-wschodni 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)

W tym przykładzie pokazujemy żądanie Find Place (starsza wersja) dotyczące „Museum of Contemporary Art Australia”, które zawiera pola photos, formatted_address, name, rating, opening_hours i geometry:

curl

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'

HTTP

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

Ten przykład pokazuje żądanie Find Place (Legacy) dla „Mongolian Grill” z użyciem parametru locationbias, aby preferować wyniki w odległości do 2000 metrów od podanych współrzędnych:

curl

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'

HTTP

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

Ten przykład pokazuje żądanie Find Place (Legacy) dotyczące numeru telefonu. Pamiętaj, że prefiks połączenia międzynarodowego „+” został zakodowany jako %2B, aby to żądanie było zgodnym adresem URL. Bez kodowania prefiks „+” zostałby zdekodowany na serwerze jako spacja, co spowodowałoby nieprawidłowe wyszukiwanie numeru telefonu.

curl

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'

HTTP

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 (starsza wersja)

Odpowiedź na żądanie Find Place (Legacy) 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 i rating.

JSON

{
  "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

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

Pole Wymagane Typ Opis
wymagane Array<Place>

Zawiera tablicę propozycji miejsc.

Żądania wyszukiwania miejsc zwracają podzbiór pól, które są zwracane przez żądania informacji o miejscu. Jeśli pole, którego potrzebujesz, nie jest zwracane przez wyszukiwanie miejsc, możesz użyć wyszukiwania miejsc, aby uzyskać identyfikator miejsca, a następnie użyć tego identyfikatora do wysłania żądania informacji o miejscu.

Więcej informacji znajdziesz w sekcji Miejsce.
wymagane PlacesSearchStatus

Zawiera stan żądania i może zawierać informacje do debugowania, które pomogą Ci ustalić, dlaczego żądanie się nie powiodło.

Więcej informacji znajdziesz w sekcji PlacesSearchStatus.

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 podanego kodu stanu. To pole nie zawsze jest zwracane, a jego zawartość może ulec zmianie.

opcjonalnie Array<string>

Gdy usługa zwraca dodatkowe informacje o specyfikacji żądania, w obiekcie odpowiedzi może pojawić się 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.

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 wyszukiwanie zostało przekazane do urządzenialatlng w odległej lokalizacji.
  • INVALID_REQUEST – żądanie do interfejsu API było nieprawidłowe, zwykle z powodu braku wymaganego parametru zapytania (location lub radius).
  • OVER_QUERY_LIMIT – oznacza dowolną z tych czynności:
    • Przekroczono limity zapytań na sekundę.
    • Na Twoim koncie nie włączono płatności.
    • Miesięczny limit środków w wysokości 200 USD lub samodzielnie ustalony limit wykorzystania został przekroczony.
    • 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, z którego wynika, że Twoja prośba została odrzucona, zwykle z tych powodów:
    • W żądaniu brakuje klucza interfejsu API.
    • Parametr key jest nieprawidłowy.
  • UNKNOWN_ERROR – wskazuje nieznany błąd.

Miejsce

Atrybuty opisujące miejsce. Nie wszystkie atrybuty będą dostępne dla wszystkich typów miejsc.

Pole Wymagane Typ Opis
opcjonalnie Array<AddressComponent>

Tablica zawierająca poszczególne komponenty, które mają zastosowanie do tego adresu.

Więcej informacji znajdziesz w sekcji AddressComponent.

opcjonalnie ciąg znaków

Reprezentacja adresu miejsca w mikroformacie adr.

opcjonalnie ciąg znaków

Wskazuje stan działania miejsca, jeśli jest to firma. Jeśli dane nie istnieją, business_status nie jest zwracany.

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
opcjonalnie Wartość logiczna

Określa, czy firma obsługuje odbiór na zewnątrz.
opcjonalnie PlaceOpeningHours

Zawiera godziny otwarcia na najbliższe 7 dni (w tym dzisiaj). Okres rozpoczyna się o północy w dniu przesłania prośby i kończy o godzinie 23:59 sześć dni później. To pole zawiera pole podrzędne special_days wszystkich godzin otwarcia ustawione dla dat, w których obowiązują niestandardowe godziny otwarcia.

Więcej informacji znajdziesz w sekcji PlaceOpeningHours.

opcjonalnie Wartość logiczna

Określa, czy firma obsługuje dostawę.
opcjonalnie Wartość logiczna

Określa, czy firma oferuje miejsca do siedzenia wewnątrz czy na zewnątrz.

opcjonalnie PlaceEditorialSummary

Zawiera podsumowanie informacji o miejscu. Podsumowanie składa się z przeglądu tekstowego, a w stosownych przypadkach zawiera też kod języka. Tekst podsumowania musi być prezentowany w niezmienionej formie i nie można go modyfikować ani zmieniać.

Więcej informacji znajdziesz w sekcji PlaceEditorialSummary.

opcjonalnie ciąg znaków

Ciąg tekstowy zawierający adres tego miejsca w formie zrozumiałej dla człowieka.

Często jest to odpowiednik adresu pocztowego. Pamiętaj, że w niektórych krajach, np. w Wielkiej Brytanii, nie można rozpowszechniać prawdziwych adresów pocztowych ze względu na ograniczenia licencyjne.

Sformatowany adres składa się logicznie z co najmniej 1 komponentu adresu. Na przykład adres „111 8th Avenue, New York, NY” składa się z tych komponentów: „111” (numer ulicy), „8th Avenue” (trasa), „New York” (miasto) i „NY” (stan w USA).

Nie analizuj sformatowanego adresu programowo. Zamiast tego używaj poszczególnych komponentów adresu, które są uwzględniane w odpowiedzi interfejsu API oprócz sformatowanego pola adresu.

opcjonalnie ciąg znaków

Zawiera numer telefonu miejsca w formacie lokalnym.

opcjonalnie Geometry

Zawiera lokalizację i obszar widoku dla lokalizacji.

Aby dowiedzieć się więcej, przeczytaj Geometry.
opcjonalnie ciąg znaków

Zawiera adres URL sugerowanej ikony, która może być wyświetlana użytkownikowi, gdy ten wskazuje ten wynik na mapie.

opcjonalnie ciąg znaków

Zawiera domyślny szesnastkowy kod koloru kategorii miejsca.
opcjonalnie ciąg znaków

Zawiera adres URL zalecanej ikony bez rozszerzenia typu pliku .svg lub .png.

opcjonalnie ciąg znaków

Zawiera numer telefonu miejsca w formacie międzynarodowym. Format międzynarodowy zawiera kod kraju i jest poprzedzony znakiem plusa (+). Na przykład numer telefonu biura Google w Sydney w Australii to +61 2 9374 4000.

opcjonalnie ciąg znaków

Zawiera zrozumiałą dla człowieka nazwę zwróconego wyniku. W przypadku wyników establishment jest to zwykle kanoniczna nazwa firmy.

opcjonalnie PlaceOpeningHours

Zawiera standardowe godziny otwarcia.

Więcej informacji znajdziesz w sekcji PlaceOpeningHours.

opcjonalnie Wartość logiczna

Użyj business_status, aby uzyskać stan operacyjny firm.

opcjonalnie Array<PlacePhoto>

Tablica obiektów zdjęć, z których każdy zawiera odwołanie do obrazu. Żądanie może zwrócić maksymalnie 10 zdjęć. Więcej informacji o zdjęciach miejsc i o tym, jak możesz wykorzystywać te obrazy w swojej aplikacji, znajdziesz w dokumentacji Place Photos.

Więcej informacji znajdziesz w sekcji PlacePhoto.
opcjonalnie ciąg znaków

Identyfikator tekstowy, który jednoznacznie identyfikuje miejsce. Aby pobrać informacje o miejscu, przekaż ten identyfikator w polu place_id żądania do interfejsu Places API. Więcej informacji o identyfikatorach miejsc znajdziesz w omówieniu identyfikatorów miejsc.

opcjonalnie PlusCode

Zakodowany odnośnik do lokalizacji, który jest wyznaczany na podstawie współrzędnych geograficznych i reprezentuje obszar o wielkości 1/8000 stopnia szerokości i 1/8000 stopnia długości geograficznej (około 14 m x 14 m na równiku) lub mniejszy. Kody Plus Code mogą zastępować adresy w miejscach, w których nie istnieją (gdzie budynki nie są ponumerowane lub ulice nie mają nazw). Zobacz Open Location Code i kody plus.

Aby dowiedzieć się więcej, przeczytaj PlusCode.
opcjonalnie liczba

Poziom cen w miejscu w skali od 0 do 4. Dokładna kwota wskazywana przez konkretną wartość będzie się różnić w zależności od regionu. Poziomy cen są interpretowane w ten sposób:

  • 0 bezpłatnych
  • 1 Niedrogo
  • 2 Umiarkowane
  • 3 Drogo
  • 4 Bardzo drogo
opcjonalnie liczba

Zawiera ocenę miejsca w skali od 1, 0 do 5, 0 na podstawie zbiorczych opinii użytkowników.

opcjonalnie ciąg znaków
opcjonalnie Wartość logiczna

Określa, czy miejsce obsługuje rezerwacje.
opcjonalnie Tablica<PlaceReview>

Tablica JSON zawierająca maksymalnie 5 opinii. Domyślnie opinie są sortowane według trafności. Do kontrolowania sortowania używaj parametru żądania reviews_sort.

  • W przypadku wartości most_relevant (domyślnej) opinie są sortowane według trafności. Usługa będzie faworyzować wyniki, aby zwracać opinie napisane pierwotnie w preferowanym języku.
  • W przypadku newest opinie są sortowane chronologicznie. Preferowany język nie ma wpływu na kolejność sortowania.

Google zaleca informowanie użytkowników, czy wyniki są uporządkowane według most_relevant czy newest.

Więcej informacji znajdziesz w sekcji PlaceReview.

opcjonalnie ciąg znaków
opcjonalnie Array<PlaceOpeningHours>

Zawiera tablicę wpisów na najbliższe 7 dni, w tym informacje o dodatkowych godzinach pracy firmy. Dodatkowe godziny otwarcia różnią się od głównych godzin otwarcia firmy. Na przykład restauracja może określić godziny otwarcia dla klientów zmotoryzowanych lub godziny dostawy jako godziny dodatkowe. To pole wypełnia pole podrzędne type, które korzysta z wstępnie zdefiniowanej listy typów godzin otwarcia (np. DRIVE_THROUGH, PICKUP lub TAKEOUT) na podstawie typów miejsca. To pole zawiera pole podrzędne special_days wszystkich godzin ustawionych dla dat, w których obowiązują niestandardowe godziny otwarcia.

Więcej informacji znajdziesz w sekcji PlaceOpeningHours.

opcjonalnie Wartość logiczna

Określa, czy w danym miejscu można napić się piwa.
opcjonalnie Wartość logiczna

Określa, czy w danym miejscu można zjeść śniadanie.
opcjonalnie Wartość logiczna

Określa, czy w tym miejscu można zjeść brunch.
opcjonalnie Wartość logiczna

Określa, czy w danym miejscu można zjeść kolację.
opcjonalnie Wartość logiczna

Określa, czy w danym miejscu można zjeść obiad.
opcjonalnie Wartość logiczna

Określa, czy w danym miejscu można zjeść dania wegetariańskie.
opcjonalnie Wartość logiczna

Określa, czy w danym miejscu serwowane jest wino.
opcjonalnie Wartość logiczna

Określa, czy firma obsługuje zamówienia na wynos.
opcjonalnie Array<string>

Zawiera tablicę typów funkcji opisujących dany wynik. Zobacz listę obsługiwanych typów.

opcjonalnie ciąg znaków

Zawiera adres URL oficjalnej strony Google tego miejsca. Będzie to strona należąca do Google, która zawiera najlepsze dostępne informacje o danym miejscu. Aplikacje muszą zawierać link do tej strony lub osadzać ją na każdym ekranie, na którym użytkownikowi wyświetlane są szczegółowe wyniki dotyczące miejsca.

opcjonalnie liczba

Łączna liczba opinii o tym miejscu (z tekstem lub bez).

opcjonalnie liczba

Zawiera liczbę minut, o którą obecna strefa czasowa tego miejsca jest przesunięta względem czasu UTC. Na przykład w przypadku miejsc w Sydney w Australii w okresie czasu letniego będzie to 660 minut (+11 godzin od UTC), a w przypadku miejsc w Kalifornii poza okresem czasu letniego będzie to -480 minut (-8 godzin od UTC).

opcjonalnie ciąg znaków

W przypadku wyników dotyczących placówek (types:["establishment", ...])) pole vicinity zawiera uproszczony adres miejsca, w tym nazwę ulicy, numer domu i miejscowość, ale nie województwo/stan, kod pocztowy ani kraj.

W przypadku wszystkich pozostałych wyników pole vicinity zawiera nazwę najwęższej jednostki administracyjnej (types:["political", ...]), która występuje w adresie wyniku.

Te treści mają być odczytywane w takiej formie, w jakiej są wyświetlane. Nie analizuj sformatowanego adresu automatycznie.

opcjonalnie ciąg znaków

Autorytatywna witryna tego miejsca, np. strona główna firmy.

opcjonalnie Wartość logiczna

Określa, czy miejsce ma wejście dostępne dla osób na wózkach.

PlaceEditorialSummary

Zawiera podsumowanie informacji o miejscu. Podsumowanie składa się z przeglądu tekstowego, a w stosownych przypadkach zawiera też kod języka. Tekst podsumowania musi być prezentowany w niezmienionej formie i nie można go modyfikować ani zmieniać.

Pole Wymagane Typ Opis
opcjonalnie ciąg znaków

Język poprzednich pól. Może nie zawsze być obecny.
opcjonalnie ciąg znaków

Średniej długości tekstowe podsumowanie miejsca.

PlaceOpeningHours

Obiekt opisujący godziny otwarcia miejsca.

Pole Wymagane Typ Opis
opcjonalnie Wartość logiczna

Wartość logiczna wskazująca, czy miejsce jest otwarte w danym momencie.

opcjonalnie Array<PlaceOpeningHoursPeriod>

Tablica okresów otwarcia obejmująca 7 dni, począwszy od niedzieli, w porządku chronologicznym.

Więcej informacji znajdziesz w sekcji PlaceOpeningHoursPeriod.

opcjonalnie Array<PlaceSpecialDay>

Tablica zawierająca maksymalnie 7 pozycji odpowiadających najbliższym 7 dniom.

Więcej informacji znajdziesz w sekcji PlaceSpecialDay.

opcjonalnie ciąg znaków

Ciąg znaków używany do identyfikowania typu dodatkowych godzin otwarcia (np. DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS). Ustawiony tylko dla secondary_opening_hours.

weekday_text

opcjonalnie Array<string>

Tablica ciągów tekstowych opisujących w formacie czytelnym dla człowieka godziny otwarcia miejsca.

PlaceOpeningHoursPeriod

Pole Wymagane Typ Opis
wymagane PlaceOpeningHoursPeriodDetail

Zawiera parę obiektów dnia i godziny opisujących, kiedy miejsce jest otwarte.

Więcej informacji znajdziesz w sekcji PlaceOpeningHoursPeriodDetail.

opcjonalnie PlaceOpeningHoursPeriodDetail

Może zawierać parę obiektów dnia i godziny opisujących, kiedy miejsce jest zamykane. Jeśli miejsce jest zawsze otwarte, w odpowiedzi nie będzie sekcji zamknięcia. Klienci mogą mieć pewność, że „zawsze otwarte” jest reprezentowane jako okres otwarcia zawierający dzień z wartością 0 i godzinę z wartością 0000, a nie close.

Więcej informacji znajdziesz w sekcji PlaceOpeningHoursPeriodDetail.

PlaceSpecialDay

Pole Wymagane Typ Opis
opcjonalnie ciąg znaków

Data podana w formacie RFC3339 w lokalnej strefie czasowej miejsca, np. 2010-12-31.

opcjonalnie Wartość logiczna

Wartość „true”, jeśli w tym dniu obowiązują wyjątkowe godziny otwarcia. Jeśli true, oznacza to, że w tym dniu obowiązuje co najmniej jeden wyjątek. Wyjątki powodują, że w polach podrzędnych current_opening_hours i secondary_opening_hours występują różne wartości, np. periods, weekday_text, open_now. Wyjątki dotyczą godzin, a godziny są używane do generowania innych pól.

PlaceOpeningHoursPeriodDetail

Pole Wymagane Typ Opis
wymagane liczba

Liczba od 0 do 6 odpowiadająca dniom tygodnia, przy czym 0 to niedziela. Na przykład 2 oznacza wtorek.

wymagane ciąg znaków

Może zawierać godzinę w formacie 24-godzinnym ggmm. Wartości mieszczą się w zakresie 0000–2359. Godzina będzie podana w strefie czasowej miejsca.

opcjonalnie ciąg znaków

Data podana w formacie RFC3339 w lokalnej strefie czasowej miejsca, np. 2010-12-31.

opcjonalnie Wartość logiczna

Wartość „prawda”, jeśli dany okres został skrócony z powodu 7-dniowego limitu, przy czym okres rozpoczyna się przed północą w dniu wysłania żądania lub kończy się o północy ostatniego dnia lub później. Ta właściwość wskazuje, że okres otwarcia lub zamknięcia może przekraczać ten 7-dniowy limit.

PlacePhoto

Zdjęcie miejsca. Do zdjęcia można uzyskać dostęp za pomocą interfejsu Place Photo API, używając adresu URL w tym formacie: 

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

Więcej informacji znajdziesz w sekcji Zdjęcia miejsca.

Pole Wymagane Typ Opis
wymagane liczba

Wysokość zdjęcia.
wymagane Array<string>

Atrybucje HTML zdjęcia.
wymagane ciąg znaków

Ciąg znaków używany do identyfikowania zdjęcia podczas wysyłania żądania Photo.

wymagane liczba

Szerokość zdjęcia.

PlaceReview

Opinia o miejscu przesłana przez użytkownika.

Pole Wymagane Typ Opis
wymagane ciąg znaków

Nazwa użytkownika, który przesłał opinię. Anonimowe opinie są przypisywane do „Użytkownika Google”.

wymagane liczba

Ogólna ocena użytkownika tego miejsca. Jest to liczba całkowita z zakresu od 1 do 5.

wymagane ciąg znaków

Czas przesłania opinii w formie tekstu w odniesieniu do bieżącego czasu.

wymagane liczba

Czas przesłania opinii, mierzony w sekundach od północy 1 stycznia 1970 r. czasu UTC.

opcjonalnie ciąg znaków

Adres URL profilu użytkownika w programie Lokalni przewodnicy w Mapach Google, jeśli jest dostępny.

opcjonalnie ciąg znaków

Kod języka IETF wskazujący język zwróconej opinii.To pole zawiera tylko główny tag języka, a nie tag dodatkowy wskazujący kraj lub region. Na przykład wszystkie opinie w języku angielskim są oznaczone jako „en”, a nie „en-AU” lub „en-UK” itd.To pole jest puste, jeśli jest tylko ocena bez tekstu opinii.

opcjonalnie ciąg znaków

Kod języka IETF wskazujący oryginalny język opinii. Jeśli opinia została przetłumaczona, to original_language != language.To pole zawiera tylko tag języka głównego, a nie tag dodatkowy wskazujący kraj lub region. Na przykład wszystkie opinie w języku angielskim są oznaczone jako „en”, a nie „en-AU” czy „en-UK” itd.To pole jest puste, jeśli jest tylko ocena bez tekstu opinii.

opcjonalnie ciąg znaków

Adres URL zdjęcia profilowego użytkownika (jeśli jest dostępny).

text

opcjonalnie ciąg znaków

opinia użytkownika, Podczas oceniania miejsca w Google Places opinie tekstowe są opcjonalne. Dlatego to pole może być puste. Pamiętaj, że to pole może zawierać podstawowy HTML. Na przykład odwołanie do jednostki &amp; może reprezentować znak ampersanda.

opcjonalnie Wartość logiczna

Wartość logiczna wskazująca, czy opinia została przetłumaczona z języka, w którym została napisana.Jeśli opinia została przetłumaczona (wartość „true”), Google zaleca poinformowanie o tym użytkowników. Możesz na przykład dodać do opinii ciąg znaków „Przetłumaczono przez Google”.