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

    Ciąg tekstowy, w którym ma zostać przeprowadzone wyszukiwanie. Musi to być nazwa miejsca, adres lub numer telefonu (np. „ul. Główna 123” lub „Ratusz”).

  • 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

  • pól,

    Uwaga: żądania wyszukiwania miejsc (starszego typu) i żądania informacji o miejscu (starszego typu) nie zwracają tych samych pól. Żądania wyszukiwania miejsc (starsza wersja) zwracają podzbiór pól, które są zwracane przez żądania szczegółów miejsca (starsza wersja). Jeśli pole, którego szukasz, nie jest zwracane przez wyszukiwanie miejsc (starsza wersja), 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 niedostępnych w żądaniu wyszukiwania miejsc (starsza wersja) znajdziesz w artykule Obsługa pól interfejsu Places API.

    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 Contact i Atmosphere – 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 (przestarzałe), 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, 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 zbiór 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 odchylenia adresu IP.

    • Odchylenie IP: instruuje interfejs API, aby używał odchylenia adresu IP. Przekaż ciąg znaków ipbias (ta opcja nie ma dodatkowych parametrów).
    • Circular: 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ących 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)

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

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) dotyczące „Mongolian Grill” z użyciem parametru locationbias, aby preferować wyniki w odległości 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 z usługi 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 wysłane do interfejsu 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 (starsza wersja) zwracają podzbiór pól, które są zwracane przez żądania informacji o miejscu (starsza wersja). Jeśli pole, którego potrzebujesz, nie jest zwracane przez wyszukiwanie miejsc (starsza wersja), możesz użyć wyszukiwania miejsc (starsza wersja), aby uzyskać identyfikator miejsca, a następnie użyć tego identyfikatora miejsca do wysłania żądania informacji o miejscu (starsza wersja).

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 nie powiodło się.

Więcej informacji znajdziesz w sekcji PlacesSearchStatus.

opcjonalnie tekst

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

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 – oznacza, że żądanie do interfejsu API było nieprawidłowe, zwykle z powodu braku wymaganego parametru zapytania (location lub radius).
  • OVER_QUERY_LIMIT – dowolny z tych elementów:
    • Przekroczono limity zapytań.
    • Na Twoim koncie nie włączono płatności.
    • Miesięczne środki w wysokości 200 USD lub samodzielnie ustalony limit wykorzystania zostały przekroczone.
    • 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 informacją, ż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 – 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 tekst

Reprezentacja adresu miejsca w mikroformacie adr.

opcjonalnie tekst

Wskazuje stan działania miejsca, jeśli jest to firma. Jeśli dane nie istnieją, parametr 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 23:59 sześć dni później. To pole zawiera pole podrzędne special_days wszystkich godzin, 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 tekstowego przeglądu, 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 tekst

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 domu), „8th Avenue” (ulica), „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 tekst

Zawiera numer telefonu miejsca w formacie lokalnym.

opcjonalnie Geometry

Zawiera lokalizację i obszar widoku dla lokalizacji.

Aby dowiedzieć się więcej, przeczytaj Geometry.
opcjonalnie tekst

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

opcjonalnie tekst

Zawiera domyślny szesnastkowy kod koloru kategorii miejsca.
opcjonalnie tekst

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

opcjonalnie tekst

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

opcjonalnie tekst

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 tekst

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 tym artykule.

opcjonalnie PlusCode

Zakodowany odnośnik do lokalizacji, który jest wyznaczany na podstawie współrzędnych szerokości i długości geograficznej i reprezentuje obszar o wielkości 1/8000 stopnia na 1/8000 stopnia (około 14 m x 14 m na równiku) lub mniejszy. Kody Plus Code mogą zastępować adresy ulic 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 tekst
opcjonalnie wartość logiczna

Określa, czy miejsce obsługuje rezerwacje.
opcjonalnie Array<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, a 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 tekst
opcjonalnie Array<PlaceOpeningHours>

Zawiera tablicę wpisów na najbliższe 7 dni, w tym informacje o dodatkowych godzinach otwarcia firmy. Dodatkowe godziny otwarcia różnią się od głównych godzin otwarcia firmy. Na przykład restauracja może określić godziny obsługi w okienku 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 serwowane są śniadania.
opcjonalnie wartość logiczna

Określa, czy w danym 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 podaje się 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 tekst

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 tekst

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ę najmniejszego obszaru politycznego (types:["political", ...]), który 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 tekst

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 tekst

Język poprzednich pól. Może nie zawsze być obecna.
opcjonalnie tekst

Ś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 bieżącym czasie.

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 tekst

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ą polegać na tym, że „zawsze otwarte” jest reprezentowane jako okres otwarcia zawierający dzień z wartością 0 i czas z wartością 0000, a nie close.

Więcej informacji znajdziesz w sekcji PlaceOpeningHoursPeriodDetail.

PlaceSpecialDay

Pole Wymagane Typ Opis
opcjonalnie tekst

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

opcjonalnie wartość logiczna

Wartość „true”, jeśli w tym dniu obowiązują godziny otwarcia inne niż standardowe. Jeśli true, oznacza to, że w tym dniu obowiązuje co najmniej 1 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 tekst

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 tekst

Data 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, a 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ć 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>

Atrybuty HTML zdjęcia.
wymagane tekst

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 tekst

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 tekst

Czas przesłania opinii w formie tekstowej 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 tekst

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

opcjonalnie tekst

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” czy „en-UK” itd.To pole jest puste, jeśli jest tylko ocena bez tekstu opinii.

opcjonalnie tekst

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 tekst

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

text

opcjonalnie tekst

opinia użytkownika, Podczas sprawdzania lokalizacji w Miejscach Google opinie tekstowe są opcjonalne. Dlatego to pole może być puste. Pamiętaj, że to pole może zawierać podstawowe znaczniki 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”.