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 konkretnej firmie lub miejscu, inicjują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 informacji o miejscu (starsza wersja) to adres URL HTTP w tym formacie:

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

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

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

Do zainicjowania żądania wyszukiwania wymagane są określone parametry. Zgodnie ze standardem adresów URL wszystkie parametry są rozdzielone znakiem ampersand (&). W sekcjach poniżej znajdziesz parametry i ich możliwe wartości.

Wymagane parametry

Parametry opcjonalne

  • pól,

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

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

    Pola są podzielone na 3 kategorie rozliczeniowe: Podstawowe, Kontakt i Atmosfera. Opłaty za kody SKU Basic, Contact i Atmosphere są naliczane dodatkowo do opłat za podstawowe kody SKU (Szczegóły miejsca, Znajdź miejsce, Wyszukiwanie w pobliżu lub Wyszukiwanie tekstowe) w przypadku żądania, które je wywołało. Więcej informacji znajdziesz w arkuszu cen.

    Podstawowe

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

    Kontakt

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

    Atmosfera

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

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

    Język, w którym mają być zwracane wyniki.

    • Zobacz listę obsługiwanych języków. Google często aktualizuje listę obsługiwanych języków, więc może ona nie być kompletna.
    • Jeśli nie podasz parametru language, interfejs API spróbuje użyć preferowanego języka określonego w nagłówku Accept-Language.
    • Interfejs API stara się podać adres, który jest czytelny zarówno dla użytkownika, jak i dla mieszkańców. Aby osiągnąć ten cel, zwraca adresy pocztowe w języku lokalnym, w razie potrzeby transliterowane na pismo czytelne dla użytkownika, z uwzględnieniem preferowanego języka. Wszystkie inne adresy są zwracane w preferowanym języku. Wszystkie komponenty adresu są zwracane w tym samym języku, który jest wybierany na podstawie pierwszego komponentu.
    • Jeśli nazwa nie jest dostępna w preferowanym języku, interfejs API używa najbliższego dopasowania.
    • Preferowany język ma niewielki wpływ na zestaw wyników, które interfejs API zwraca, oraz na kolejność, w jakiej są zwracane. Geokoder interpretuje skróty w różny sposób w zależności od języka, np. skróty typów ulic lub synonimy, które mogą być prawidłowe w jednym języku, ale nie w innym. Na przykład utca i tér to synonimy słowa „ulica” w języku węgierskim.
  • region

    Kod regionu określony jako dwuznakowa wartość ccTLD („domena najwyższego poziomu”). Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma istotnymi wyjątkami. Na przykład domena ccTLD 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 będzie włączone. Jeśli w żądaniu określono 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ślna) lub newest.

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

    Google zaleca wyświetlanie użytkownikowi informacji o tym, jak opinie są sortowane.

  • sessiontoken

    Losowy ciąg znaków, który identyfikuje sesję autouzupełniania do celów rozliczeniowych.

    Sesja rozpoczyna się, gdy użytkownik zaczyna wpisywać zapytanie, a kończy, gdy wybiera miejsce i wywoływana jest usługa informacje o miejscu (starsza wersja). Każda sesja może obejmować wiele zapytań, po których następuje wybór jednego miejsca. Klucze interfejsu API używane w przypadku każdego żądania w ramach sesji muszą należeć do tego samego projektu w Google Cloud Console. Po zakończeniu sesji token traci ważność. Aplikacja musi wygenerować nowy token dla każdej sesji. Jeśli parametr sessiontoken zostanie pominięty lub jeśli użyjesz ponownie tokena sesji, sesja zostanie rozliczona tak, jakby nie podano tokena sesji (każde żądanie jest rozliczane osobno).

    Zalecamy stosowanie się do 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życie tego samego tokena w więcej niż 1 sesji spowoduje, że każde żądanie będzie rozliczane osobno.

Przykład informacji o miejscu (starsza wersja)

W tym przykładzie żądanie dotyczy szczegółów miejsca według 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

Zastąp klucz w tym przykładzie własnym kluczem interfejsu API, aby żądanie działało w Twojej aplikacji.

Odpowiedź informacji o miejscu (starsza wersja)

Odpowiedzi z informacjami 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,
          },
          // ...
        ],
      "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,
          },
          // ...
        ],
      "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>
  <!-- ... -->
  <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>
  <!-- ... -->
  <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 JSON i XML zawierają te elementy:

PlacesDetailsResponse

Pole Wymagane Typ Opis
wymagane Array<string>

Może zawierać zestaw atrybucji dotyczących tej oferty, które muszą być wyświetlane użytkownikowi (niektóre oferty 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 na potrzeby debugowania, które pomogą Ci ustalić, dlaczego żądanie się nie powiodło.

Więcej informacji znajdziesz w sekcji PlacesDetailsStatus.

opcjonalnie Array<string>

Gdy usługa zwraca dodatkowe informacje o specyfikacji żądania, w obiekcie odpowiedzi może znajdować 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 pojawiają się one jako elementy najwyższego poziomu pod <PlaceDetailsResponse>.

PlacesDetailsStatus

Kody stanu zwracane przez usługę.

  • OK, co oznacza, że żądanie do interfejsu API zostało zrealizowane.
  • ZERO_RESULTS, co oznacza, że wskazana lokalizacja place_id była prawidłowa, ale nie odnosi się już do prawidłowego wyniku. Może się tak zdarzyć, jeśli firma już nie działa.
  • 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, który zawiera dowolną z tych informacji:
    • Przekroczono limity zapytań na sekundę.
    • Na Twoim koncie nie włączono płatności.
    • Przekroczono miesięczny limit środków w wysokości 200 USD lub samodzielnie nałożony limit wykorzystania.
    • Podana forma płatności nie jest już ważna (np. karta kredytowa straciła ważność).
    Więcej informacji o tym, jak rozwiązać ten problem, znajdziesz w najczęstszych pytaniach dotyczących Map.
  • REQUEST_DENIED z informacją, że Twoja prośba została odrzucona. Zwykle dzieje się tak, ponieważ:
    • W żądaniu brakuje klucza interfejsu API.
    • Parametr key jest nieprawidłowy.
  • UNKNOWN_ERROR wskazujący nieznany błąd.

Miejsce

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 oddzielne komponenty, które mają zastosowanie do tego adresu.

Więcej informacji znajdziesz na stronie AddressComponent.

opcjonalnie tekst

Adres miejsca w mikroformacie adr.

opcjonalnie tekst

Wskazuje status działalności miejsca, jeśli jest to firma. Jeśli nie ma żadnych danych, 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 w ciągu najbliższych 7 dni (w tym dzisiaj). Okres ten rozpoczyna się o północy w dniu przesłania prośby i kończy o 23:59 6 dni później. 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 artykule PlaceOpeningHours.

opcjonalnie wartość logiczna

Określa, czy firma oferuje dostawę.

opcjonalnie wartość logiczna

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

opcjonalnie PlaceEditorialSummary

Zawiera podsumowanie informacji o miejscu. Podsumowanie składa się z tekstowego przeglądu i zawiera kod języka (jeśli dotyczy). 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 zrozumiały dla człowieka adres tego miejsca.

Często jest on taki sam jak adres pocztowy. Pamiętaj, że w niektórych krajach, np. w Wielkiej Brytanii, ze względu na ograniczenia licencyjne nie można rozpowszechniać prawdziwych adresów pocztowych.

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

Nie analizuj sformatowanego adresu automatycznie. Zamiast tego użyj poszczególnych komponentów adresu, które odpowiedź interfejsu API zawiera oprócz sformatowanego pola adresu.

opcjonalnie tekst

Zawiera numer telefonu miejsca w formacie lokalnym.

opcjonalnie Geometry

Zawiera lokalizację i obszar widoczny dla lokalizacji.

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

opcjonalnie tekst

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

opcjonalnie tekst

Zawiera domyślny szesnastkowy kod koloru kategorii miejsca.

opcjonalnie tekst

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

opcjonalnie tekst

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

opcjonalnie tekst

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

opcjonalnie PlaceOpeningHours

Zawiera standardowe godziny otwarcia.

Więcej informacji znajdziesz w artykule PlaceOpeningHours.

opcjonalnie wartość logiczna

Użyj business_status, aby uzyskać status działalności 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 ich używać w aplikacji, znajdziesz w dokumentacji zdjęć miejsc.

Więcej informacji znajdziesz w artykule 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 omówieniu identyfikatorów miejsc.

opcjonalnie PlusCode

Zakodowane odniesienie do lokalizacji, uzyskane na podstawie współrzędnych szerokości i długości geograficznej, które reprezentuje obszar: 1/8000 stopnia na 1/8000 stopnia (około 14 m x 14 m na równiku) lub mniejszy. Plus codes mogą zastępować adresy ulic w miejscach, gdzie ich nie ma (gdzie budynki nie są ponumerowane lub ulice nie mają nazw). Zobacz Open Location Code i kody Plus Code.

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

opcjonalnie liczba

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

  • 0 bezpłatnie
  • 1 Niedrogo
  • 2 – umiarkowana
  • 3 Drogie
  • 4 Bardzo drogo
opcjonalnie liczba

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

opcjonalnie tekst
opcjonalnie wartość logiczna

Określa, czy w miejscu można dokonywać rezerwacji.

opcjonalnie Array<PlaceReview>

Tablica JSON zawierająca maksymalnie 5 opinii. Domyślnie opinie są sortowane według trafności. Aby kontrolować sortowanie, użyj 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, które zwracają opinie napisane 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 artykule PlaceReview.

opcjonalnie tekst
opcjonalnie Array<PlaceOpeningHours>

Zawiera tablicę wpisów dotyczących kolejnych 7 dni, w tym informacje o dodatkowych godzinach otwarcia firmy. Dodatkowe godziny otwarcia różnią się od głównych godzin otwarcia firmy. Na przykład restauracja może określić godziny obsługi drive-through lub dostawy jako dodatkowe godziny otwarcia. To pole wypełnia podpola type, które pobierają dane ze wstępnie zdefiniowanej listy typów godzin otwarcia (takich jak 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 artykule PlaceOpeningHours.

opcjonalnie wartość logiczna

Określa, czy w miejscu serwowane jest piwo.

opcjonalnie wartość logiczna

Określa, czy w miejscu można zjeść śniadanie.

opcjonalnie wartość logiczna

Określa, czy w 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 miejscu można zjeść obiad.

opcjonalnie wartość logiczna

Określa, czy w miejscu serwowane są dania wegetariańskie.

opcjonalnie wartość logiczna

Określa, czy w miejscu serwowane jest wino.

opcjonalnie wartość logiczna

Określa, czy firma oferuje dania na wynos.

opcjonalnie Array<string>

Zawiera tablicę typów cech 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 miejscu. Aplikacje muszą zawierać link do tej strony lub umieszczać ją na każdym ekranie, na którym użytkownik widzi 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ą bieżąca strefa czasowa tego miejsca jest przesunięta względem czasu UTC. Na przykład w przypadku miejsc w Sydney w Australii w czasie letnim będzie to 660 (+11 godzin od UTC), a w przypadku miejsc w Kalifornii poza czasem letnim będzie to -480 (-8 godzin od UTC).

opcjonalnie tekst

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

W przypadku wszystkich innych wyników pole vicinity zawiera nazwę najbardziej szczegółowego elementu politycznego (types:["political", ...]) obecnego w adresie wyniku.

Te treści powinny być odczytywane w takiej postaci, w jakiej są. Nie analizuj sformatowanego adresu automatycznie.

opcjonalnie tekst

Oficjalna 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 tekstowego przeglądu i zawiera też kod języka (jeśli dotyczy). Tekst podsumowania musi być prezentowany w niezmienionej postaci 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 miejsca.

PlaceOpeningHours

Obiekt opisujący godziny otwarcia miejsca.

Pole Wymagane Typ Opis
opcjonalnie wartość logiczna

Wartość logiczna wskazująca, czy miejsce jest obecnie otwarte.

opcjonalnie thought Array<PlaceOpeningHoursPeriod>

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

Więcej informacji znajdziesz w sekcji PlaceOpeningHoursPeriod.

opcjonalnie Array<PlaceSpecialDay>

Tablica zawierająca maksymalnie 7 wpisów odpowiadających kolejnym 7 dniom.

Więcej informacji znajdziesz w artykule PlaceSpecialDay.

opcjonalnie tekst

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

opcjonalnie Array<string>

Tablica ciągów tekstowych opisujących w zrozumiały dla człowieka sposób godziny otwarcia miejsca.

PlaceOpeningHoursPeriod

Pole Wymagane Typ Opis
wymagane PlaceOpeningHoursPeriodDetail

Zawiera parę obiektów dnia i godziny, które określają, kiedy miejsce jest otwierane.

Więcej informacji znajdziesz w artykule PlaceOpeningHoursPeriodDetail.

opcjonalnie PlaceOpeningHoursPeriodDetail

Może zawierać parę obiektów dnia i godziny, które określają, kiedy miejsce jest zamykane. Jeśli miejsce jest zawsze otwarte, w odpowiedzi nie będzie sekcji dotyczącej zamknięcia. Klienci mogą polegać na tym, że zawsze otwarte jest reprezentowane jako okres otwarcia zawierający dzień o wartości 0 i godzinę o wartości 0000, bez close.

Więcej informacji znajdziesz w artykule PlaceOpeningHoursPeriodDetail.

PlaceSpecialDay

Pole Wymagane Typ Opis
opcjonalnie tekst

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

opcjonalnie wartość logiczna

Wartość „true”, jeśli w tym dniu obowiązują niestandardowe godziny otwarcia. Jeśli true, oznacza to, że w tym dniu jest co najmniej 1 wyjątek. Wyjątki powodują występowanie różnych wartości w podpolach current_opening_hours i secondary_opening_hours, takich jak 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, zaczynając od niedzieli. 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 wyrażona w formacie RFC3339 w lokalnej strefie czasowej miejsca, np. 2010-12-31.

opcjonalnie wartość logiczna

Wartość „True”, jeśli dany okres został skrócony z powodu 7-dniowego limitu, gdy okres rozpoczyna się przed północą w dniu przesłania prośby lub kończy się o północy lub później ostatniego dnia. 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 o następującym wzorcu:

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

Więcej informacji znajdziesz w artykule na temat zdjęć 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 zdjęcia.

wymagane liczba

Szerokość zdjęcia.

PlaceReview

Opinia o miejscu przesłana przez użytkownika.

Pole Wymagane Typ Opis
wymagane tekst

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

wymagane liczba

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

wymagane tekst

Czas przesłania opinii w formie tekstowej, względem 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 Lokalnego przewodnika w Mapach Google, jeśli jest dostępny.

opcjonalnie tekst

Kod języka IETF wskazujący język zwróconej opinii.To pole zawiera tylko główny tag języka, a nie tag dodatkowy wskazujący kraj lub region. Na przykład wszystkie opinie w języku angielskim są oznaczone jako „en”, a nie „en-AU” czy „en-UK”. 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, original_language != language.To pole zawiera tylko główny tag języka, a nie tag dodatkowy wskazujący kraj lub region. Na przykład wszystkie opinie w języku angielskim są oznaczone jako „en”, a nie „en-AU” czy „en-UK”. 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ępne.

opcjonalnie tekst

Opinia użytkownika. W przypadku opinii o lokalizacji w Miejscach Google opinie tekstowe są uznawane za opcjonalne. Dlatego to pole może być puste. Pamiętaj, że to pole może zawierać podstawowy HTML. Na przykład odwołanie do encji &amp; może reprezentować znak ampersand.

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, co odpowiada wartości „true”, Google zaleca poinformowanie o tym użytkowników. Możesz na przykład dodać do opinii ciąg tekstowy „Przetłumaczone przez Google”.