Informacje o miejscu (starsza wersja)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Gdy uzyskasz place_id z wyszukiwania miejsc, możesz poprosić o więcej informacji o konkretnym obiekcie lub punkcie orientacyjnym, wysyłając żądanie informacji o miejscu (starsza wersja). Żądanie informacji o miejscu (starsza wersja) zwraca bardziej szczegółowe informacje o wskazanym miejscu, takie jak pełny adres, numer telefonu, oceny i opinie użytkowników.

Żądania informacji o miejscu (starsza wersja)

Żądanie szczegółów miejsca (starsza wersja) to adres URL HTTP w tej postaci:

https://maps.googleapis.com/maps/api/place/details/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 wyszukiwania, 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

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 informacji o miejscu (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, które są niedostępne w przypadku żądania wyszukiwania miejsca (starszego), znajdziesz w sekcji Pola danych o miejscu (starsze).

    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. 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ć wyczerpująca.
    • 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 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 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.

  • region

    Kod regionu podany jako ccTLD („domena najwyższego poziomu”), czyli wartość dwuznakowa. Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma wyjątkami. Na przykład krajowa domena najwyższego poziomu Wielkiej Brytanii to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej”).

  • reviews_no_translations

    Wpisz reviews_no_translations=true, aby wyłączyć tłumaczenie opinii, lub reviews_no_translations=false, aby je włączyć. Opinie są zwracane w języku oryginalnym.

    Jeśli ten parametr zostanie pominięty lub przekazany bez wartości, tłumaczenie opinii zostanie włączone. Jeśli w żądaniu podano parametr language, użyj określonego języka jako preferowanego języka tłumaczenia. Jeśli parametr language zostanie pominięty, interfejs API spróbuje użyć nagłówka Accept-Language jako preferowanego języka.

  • reviews_sort

    Metoda sortowania, która ma być używana podczas zwracania opinii. Może mieć wartość most_relevant (domyślnie) lub newest.

    • 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 wyświetlanie użytkownikom informacji o sposobie sortowania opinii.

  • sessiontoken

    Losowy ciąg znaków, który identyfikuje sesję autouzupełniania na potrzeby rozliczeń.

    Sesja rozpoczyna się, gdy użytkownik zaczyna wpisywać zapytanie, a kończy, gdy wybierze miejsce i wykona wywołanie informacji o miejscu (starsza wersja). Każda sesja może zawierać wiele zapytań, po których następuje wybór jednego miejsca. Klucze API używane w każdym żądaniu w ramach sesji muszą należeć do tego samego projektu w konsoli Google Cloud. Po zakończeniu sesji token traci ważność. Aplikacja musi generować nowy token dla każdej sesji. Jeśli parametr sessiontoken zostanie pominięty lub jeśli użyjesz ponownie tokena sesji, sesja zostanie obciążona tak, jakby nie podano tokena sesji (każde żądanie jest rozliczane osobno).

    Zalecamy stosowanie tych wskazówek:

    • Używaj tokenów sesji we wszystkich sesjach autouzupełniania.
    • Generuj nowy token dla każdej sesji. Zalecany jest identyfikator UUID w wersji 4.
    • Upewnij się, że klucze interfejsu API używane we wszystkich żądaniach Autouzupełniania miejsc i informacji o miejscu w ramach sesji należą do tego samego projektu w Konsoli Cloud.
    • Pamiętaj, aby przekazywać unikalny token sesji dla każdej nowej sesji. Używanie tego samego tokena w przypadku więcej niż 1 sesji spowoduje naliczenie opłaty za każde żądanie osobno.

Przykład informacji o miejscu (starsza wersja)

Ten przykład wysyła prośbę o szczegóły miejsca za pomocą parametru place_id i zawiera pola name, rating i formatted_phone_number:

Muszla

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/details/json
  ?fields=name%2Crating%2Cformatted_phone_number
  &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4
  &key=YOUR_API_KEY

Pamiętaj, że aby żądanie działało w Twojej aplikacji, musisz zastąpić klucz w tym przykładzie własnym kluczem interfejsu API.

Odpowiedź informacje o miejscu (starsza wersja)

Odpowiedzi dotyczące informacji o miejscu (starsza wersja) są zwracane w formacie wskazanym przez flagę output w ścieżce adresu URL żądania.

JSON

{
  "html_attributions": [],
  "result":
    {
      "address_components":
        [
          { "long_name": "48", "short_name": "48", "types": ["street_number"] },
          {
            "long_name": "Pirrama Road",
            "short_name": "Pirrama Rd",
            "types": ["route"],
          },
          {
            "long_name": "Pyrmont",
            "short_name": "Pyrmont",
            "types": ["locality", "political"],
          },
          {
            "long_name": "City of Sydney",
            "short_name": "City of Sydney",
            "types": ["administrative_area_level_2", "political"],
          },
          {
            "long_name": "New South Wales",
            "short_name": "NSW",
            "types": ["administrative_area_level_1", "political"],
          },
          {
            "long_name": "Australia",
            "short_name": "AU",
            "types": ["country", "political"],
          },
          {
            "long_name": "2009",
            "short_name": "2009",
            "types": ["postal_code"],
          },
        ],
      "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "business_status": "OPERATIONAL",
      "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "formatted_phone_number": "(02) 9374 4000",
      "geometry":
        {
          "location": { "lat": -33.866489, "lng": 151.1958561 },
          "viewport":
            {
              "northeast":
                { "lat": -33.8655112697085, "lng": 151.1971156302915 },
              "southwest":
                { "lat": -33.86820923029149, "lng": 151.1944176697085 },
            },
        },
      "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
      "icon_background_color": "#7B9EB0",
      "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
      "international_phone_number": "+61 2 9374 4000",
      "name": "Google Workplace 6",
      "opening_hours":
        {
          "open_now": false,
          "periods":
            [
              {
                "close": { "day": 1, "time": "1700" },
                "open": { "day": 1, "time": "0900" },
              },
              {
                "close": { "day": 2, "time": "1700" },
                "open": { "day": 2, "time": "0900" },
              },
              {
                "close": { "day": 3, "time": "1700" },
                "open": { "day": 3, "time": "0900" },
              },
              {
                "close": { "day": 4, "time": "1700" },
                "open": { "day": 4, "time": "0900" },
              },
              {
                "close": { "day": 5, "time": "1700" },
                "open": { "day": 5, "time": "0900" },
              },
            ],
          "weekday_text":
            [
              "Monday: 9:00 AM – 5:00 PM",
              "Tuesday: 9:00 AM – 5:00 PM",
              "Wednesday: 9:00 AM – 5:00 PM",
              "Thursday: 9:00 AM – 5:00 PM",
              "Friday: 9:00 AM – 5:00 PM",
              "Saturday: Closed",
              "Sunday: Closed",
            ],
        },
      "photos":
        [
          {
            "height": 3024,
            "html_attributions":
              [
                "Cynthia Wei",
              ],
            "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX",
            "width": 4032,
          },
          {
            "height": 3264,
            "html_attributions":
              [
                "Heyang Li",
              ],
            "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI",
            "width": 4912,
          },
          {
            "height": 3036,
            "html_attributions":
              [
                "Anna Linetsky",
              ],
            "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1",
            "width": 4048,
          },
          {
            "height": 4016,
            "html_attributions":
              [
                "Jonah Dell",
              ],
            "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD",
            "width": 6016,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Anthony Huynh",
              ],
            "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jasen Baker",
              ],
            "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk",
            "width": 4032,
          },
          {
            "height": 1515,
            "html_attributions":
              [
                "Andrew W",
              ],
            "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI",
            "width": 2048,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39",
            "width": 4032,
          },
          {
            "height": 4032,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uECQynuD_EnSnbz8sJQ6-B6uR-j2tuu4Z1tuGUjq8xnxFDk-W8OdeLzWBX8suNKTCsPlkzTqC22BXf_hX33XclGPL4SS9xnPmHcMrLoUl0H_xHYevFvT17Hgw5DZpSyVmLvDvxzzJ1rsZTh55QwopmAty083a1r1ZIfL32iXh_q8FUas",
            "width": 3024,
          },
        ],
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "plus_code":
        {
          "compound_code": "45MW+C8 Pyrmont NSW, Australia",
          "global_code": "4RRH45MW+C8",
        },
      "rating": 4,
      "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "reviews":
        [
          {
            "author_name": "Luke Archibald",
            "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "a week ago",
            "text": "Beautiful building with a great view.",
            "time": 1652286798,
          },
          {
            "author_name": "Tevita Taufoou",
            "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "6 months ago",
            "text": "Conference rooms were well equipped.",
            "time": 1637215605,
          },
          {
            "author_name": "Jordy Baker",
            "author_url": "https://www.google.com/maps/contrib/102582237417399865640/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The staff is very friendly.",
            "time": 1641389490,
          },
          {
            "author_name": "Prem Rathod",
            "author_url": "https://www.google.com/maps/contrib/115981614018592114142/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The location is convenient and easy to find.",
            "time": 1640159655,
          },
          {
            "author_name": "Husuni Hamza",
            "author_url": "https://www.google.com/maps/contrib/102167316656574288776/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo",
            "rating": 5,
            "relative_time_description": "7 months ago",
            "text": "A modern and impressive facility.",
            "time": 1633197305,
          },
        ],
      "types": ["point_of_interest", "establishment"],
      "url": "https://maps.google.com/?cid=10281119596374313554",
      "user_ratings_total": 939,
      "utc_offset": 600,
      "vicinity": "48 Pirrama Road, Pyrmont",
      "website": "http://google.com/",
    },
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Workplace 6</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>point_of_interest</type>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address>
  <address_component>
   <long_name>48</long_name>
   <short_name>48</short_name>
   <type>street_number</type>
  </address_component>
  <address_component>
   <long_name>Pirrama Road</long_name>
   <short_name>Pirrama Rd</short_name>
   <type>route</type>
  </address_component>
  <address_component>
   <long_name>Pyrmont</long_name>
   <short_name>Pyrmont</short_name>
   <type>locality</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>City of Sydney</long_name>
   <short_name>City of Sydney</short_name>
   <type>administrative_area_level_2</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>New South Wales</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>Australia</long_name>
   <short_name>AU</short_name>
   <type>country</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>2009</long_name>
   <short_name>2009</short_name>
   <type>postal_code</type>
  </address_component>
  <geometry>
   <location>
    <lat>-33.8664890</lat>
    <lng>151.1958561</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8682092</lat>
     <lng>151.1944177</lng>
    </southwest>
    <northeast>
     <lat>-33.8655113</lat>
     <lng>151.1971156</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <url>https://maps.google.com/?cid=10281119596374313554</url>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://google.com/</website>
  <review>
   <time>1652286798</time>
   <text>Beautiful building with a great view.</text>
   <author_name>Luke Archibald</author_name>
   <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>a week ago</relative_time_description>
  </review>
  <review>
   <time>1637215605</time>
   <text>Conference rooms were well equipped.</text>
   <author_name>Joe Schmoe</author_name>
   <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>6 months ago</relative_time_description>
  </review>
  <review>
   <time>1641389490</time>
   <text>The staff is very friendly.</text>
   <author_name>Jordy Baker</author_name>
   <author_url>https://www.google.com/maps/contrib/102582237417399865640/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1640159655</time>
   <text>The location is convenient and easy to find.</text>
   <author_name>Prem Rathod</author_name>
   <author_url>https://www.google.com/maps/contrib/115981614018592114142/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1633197305</time>
   <text>A modern and impressive facility.</text>
   <author_name>Husuni Hamza</author_name>
   <author_url>https://www.google.com/maps/contrib/102167316656574288776/reviews</author_url>
   <rating>5.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>7 months ago</relative_time_description>
  </review>
  <opening_hours>
   <open_now>false</open_now>
   <period>
    <open>
     <day>1</day>
     <time>0900</time>
    </open>
    <close>
     <day>1</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>2</day>
     <time>0900</time>
    </open>
    <close>
     <day>2</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>3</day>
     <time>0900</time>
    </open>
    <close>
     <day>3</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>4</day>
     <time>0900</time>
    </open>
    <close>
     <day>4</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>5</day>
     <time>0900</time>
    </open>
    <close>
     <day>5</day>
     <time>1700</time>
    </close>
   </period>
   <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Saturday: Closed</weekday_text>
   <weekday_text>Sunday: Closed</weekday_text>
  </opening_hours>
  <utc_offset>600</utc_offset>
  <photo>
   <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference>
   <width>4048</width>
   <height>3036</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104829437842034782235&quot;&gt;Anna Linetsky&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference>
   <width>6016</width>
   <height>4016</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/107755640736541028674&quot;&gt;Jonah Dell&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/115886271727815775491&quot;&gt;Anthony Huynh&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102939237947063969663&quot;&gt;Jasen Baker&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference>
   <width>2048</width>
   <height>1515</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112343109286948028063&quot;&gt;Andrew W&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEADyMSxLevgbLWCJeHA8kIN3w6-JcndbuHvTB0oqR-IlWbml4bbYmR-_iYU15HBh8xi3w5hZ455pda6m-BlLCscr6g_Zc5FmBOHW56IsZF3Pxif5UmeGZSsg3WIjHCoL-JyndN0nkfyzS31E05tZi61RfXQ2UPY2_5ceKYua5U6d5Zd</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</adr_address>
  <user_ratings_total>939</user_ratings_total>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <plus_code>
   <global_code>4RRH45MW+C8</global_code>
   <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceDetailsResponse>

Odpowiedzi w formatach JSON i XML zawierają te elementy:

PlacesDetailsResponse

Pole Wymagane Typ Opis
wymagane Array<string>

Może zawierać zestaw atrybucji dotyczących tej wizytówki, które muszą być wyświetlane użytkownikowi (niektóre wizytówki mogą nie mieć atrybucji).

wymagane Miejsce

Zawiera szczegółowe informacje o wybranym miejscu.

Więcej informacji znajdziesz w sekcji Miejsce.
wymagane PlacesDetailsStatus

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

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.

W odpowiedzi JSON są one reprezentowane jako elementy główne. W odpowiedzi XML są one wyświetlane jako elementy najwyższego poziomu pod elementem <PlaceDetailsResponse>.

PlacesDetailsStatus

Kody stanu zwracane przez usługę.

  • OK, co oznacza, że żądanie do interfejsu API zostało zrealizowane.
  • ZERO_RESULTS, co oznacza, że lokalizacja, do której się odnosi, place_id, była prawidłowa, ale nie odnosi się już do prawidłowego wyniku. Może się tak zdarzyć, jeśli firma nie prowadzi już działalności.
  • NOT_FOUND, co oznacza, że wskazana lokalizacja place_id nie została znaleziona w bazie danych Miejsc.
  • INVALID_REQUEST, co oznacza, że żądanie do interfejsu API było nieprawidłowe.
  • OVER_QUERY_LIMIT – wskazuje dowolną z tych wartoś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 utraciła ważność).
    Więcej informacji o tym, jak rozwiązać ten problem, 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.

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

opcjonalnie tekst

Reprezentacja adresu miejsca w mikroformacie adr.

opcjonalnie tekst

Wskazuje stan operacyjny miejsca, jeśli jest to firma. Jeśli nie ma żadnych danych, 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 godzinie 23:59 sześć dni później. To pole zawiera pole podrzędne special_days wszystkich godzin otwarcia ustawionych na daty, 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 tekst

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

Często jest to adres pocztowy. 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 logicznie składa się 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ą zawarte 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 podczas wskazywania tego wyniku na mapie.

opcjonalnie tekst

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

Zawiera adres URL zalecanej ikony bez rozszerzenia 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 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 znormalizowana nazwa firmy.

opcjonalnie PlaceOpeningHours

Zawiera regularne 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 cenowe 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 artykule 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 drive-through 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 tym 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 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 czasu UTC), a w przypadku miejsc w Kalifornii poza okresem czasu letniego będzie to -480 minut (-8 godzin od czasu 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 zawiera województwa/stanu, kodu pocztowego ani kraju.

W przypadku wszystkich innych wyników pole vicinity zawiera nazwę najwęższego obiektu 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 także kodu języka (w stosownych przypadkach). 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ć obecny.
opcjonalnie tekst

Średniej długości tekstowe podsumowanie informacji o miejscu.

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 tekst

Ciąg znaków typu używany do identyfikowania typu godzin dodatkowych (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 zawierających zrozumiały dla człowieka opis godzin 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ń o wartości 0 i godzinę o 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ść „prawda”, jeśli w tym dniu obowiązują wyjątkowe godziny otwarcia. 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, które są używane do generowania pozostałych pól.

PlaceOpeningHoursPeriodDetail

Pole Wymagane Typ Opis
wymagane liczba

Liczba od 0 do 6 odpowiadająca dniom tygodnia, przy czym niedziela jest pierwszym dniem. 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. Czas będzie podawany 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, przy czym okres rozpoczyna się przed północą w dniu wysłania żądania lub kończy się o północy w ostatnim dniu lub później. Ta właściwość wskazuje, że okres otwarcia lub zamknięcia może wykraczać poza ten 7-dniowy limit.

PlacePhoto

Zdjęcie miejsca. Dostęp do zdjęcia można uzyskać 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 miejsc.

Pole Wymagane Typ Opis
wymagane liczba

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

Atrybucje 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” lub „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” lub „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 oceniania miejsca 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 encji &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”.