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 (Legacy) zwraca bardziej szczegółowe informacje o wskazanym miejscu, takie jak pełny adres, numer telefonu, oceny i opinie użytkowników.

Prośby o informacje o miejscu (starsza wersja)

Żądanie informacji o miejscu (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, musisz podać określone parametry. Zgodnie ze standardem adresów URL wszystkie parametry są rozdzielane znakiem ampersand (&). Poniżej znajdziesz listę parametrów i ich możliwych wartości.

Wymagane parametry

  • place_id

    Identyfikator tekstowy, który jednoznacznie identyfikuje miejsce i jest zwracany przez wyszukiwanie miejsc. Więcej informacji o identyfikatorach miejsc znajdziesz w tym artykule.

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

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

  • region

    Kod regionu określony jako 2-znakowa wartość ccTLD („domena najwyższego poziomu”). Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma znaczącymi wyjątkami. Na przykład krajowa domena najwyższego poziomu Zjednoczonego Królestwa 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

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

    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żna ustawić 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 wywoła informacje o miejscu. 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 ponownie użyjesz tokena sesji, sesja zostanie obciążona tak, jakby nie podano tokena sesji (każde żądanie jest rozliczane osobno).

    Zalecamy stosowanie tych wytycznych:

    • 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ż jednej sesji spowoduje naliczenie opłaty za każde żądanie z osobna.

Przykład informacji o miejscu (starsza wersja)

W tym przykładzie wysyłamy prośbę o szczegóły miejsca za pomocą parametru place_id i uwzględniamy 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ź interfejsu 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 informacji o pochodzeniu danych dotyczących tej wizytówki, które muszą być wyświetlane użytkownikowi (niektóre wizytówki mogą nie mieć informacji o pochodzeniu danych).

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 zostało zrealizowane.

Więcej informacji znajdziesz w sekcji PlacesDetailsStatus.

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.

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 placówka nie prowadzi już działalności.
  • NOT_FOUND, co oznacza, że wskazanej lokalizacji place_id nie znaleziono w bazie danych Miejsc.
  • INVALID_REQUEST, co oznacza, że żądanie do interfejsu API było nieprawidłowe.
  • 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”.