Place Details (Lama)

Developer Wilayah Ekonomi Eropa (EEA)

Setelah memiliki place_id dari penelusuran tempat, Anda dapat meminta detail selengkapnya tentang tempat usaha atau lokasi menarik tertentu dengan memulai permintaan Place Details (Lama). Permintaan Place Details (Lama) menampilkan informasi yang lebih komprehensif tentang tempat yang ditunjukkan, seperti alamat lengkap, nomor telepon, rating pengguna, dan ulasan pengguna.

Permintaan Place Details (Lama)

Permintaan Place Details (Lama) adalah URL HTTP dengan format berikut:

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

dengan output dapat berupa salah satu dari nilai berikut:

  • json (direkomendasikan) menunjukkan output dalam JavaScript Object Notation (JSON)
  • xml menunjukkan output sebagai XML

Diperlukan parameter tertentu untuk memulai permintaan penelusuran. Sesuai dengan standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&). Bagian berikut mencantumkan parameter dan kemungkinan nilainya.

Parameter yang diperlukan

Parameter opsional

  • Fields

    Perhatian: Permintaan Place Search (Lama) dan permintaan Place Details (Lama) tidak menampilkan kolom yang sama. Permintaan Place Search (Lama) menampilkan sub-kumpulan kolom yang ditampilkan berdasarkan permintaan Place Details (Lama). Jika kolom yang Anda inginkan tidak ditampilkan oleh Place Search (Lama), Anda dapat menggunakan Place Search (Lama) untuk mendapatkan place_id, lalu menggunakan ID Tempat tersebut untuk membuat permintaan Place Details (Lama). Untuk mengetahui informasi selengkapnya tentang kolom yang tidak tersedia dalam permintaan Place Search (Lama), lihat Kolom Data Tempat (Lama).

    Gunakan parameter fields untuk menentukan daftar jenis data tempat yang dipisahkan koma untuk ditampilkan. Contoh: fields=formatted_address,name,geometry. Gunakan garis miring saat menentukan nilai gabungan. Contoh: opening_hours/open_now.

    Kolom dibagi menjadi tiga kategori penagihan: Basic, Contact, dan Atmosphere. SKU Basic, Contact, dan Atmosphere dikenai biaya selain SKU dasar (Places Details, Find Place, Nearby Search, atau Text Search) untuk permintaan yang memicunya. Untuk mengetahui informasi selengkapnya, lihat sheet harga.

    Basic

    Kategori Basic mencakup kolom berikut: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (tidak digunakan lagi), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

    Kontak

    Kategori Contact mencakup kolom berikut: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

    Atmosphere

    Kategori Atmosphere mencakup kolom berikut: 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.

    Catatan: Atribusi, html_attributions, selalu ditampilkan dengan setiap panggilan, terlepas dari apakah kolom telah diminta atau tidak.
  • bahasa

    Bahasa yang digunakan untuk menampilkan hasil.

    • Lihat daftar bahasa yang didukung. Google sering memperbarui bahasa yang didukung, sehingga daftar ini mungkin tidak lengkap.
    • Jika language tidak diberikan, API akan mencoba menggunakan bahasa pilihan seperti yang ditentukan di header Accept-Language.
    • API ini berupaya sebaik mungkin untuk memberikan alamat yang dapat dibaca oleh pengguna dan penduduk setempat. Untuk mencapai tujuan tersebut, API ini menampilkan alamat jalan dalam bahasa lokal, yang ditransliterasikan ke skrip yang dapat dibaca oleh pengguna jika perlu, dengan mengamati bahasa pilihan. Semua alamat lainnya ditampilkan dalam bahasa pilihan. Komponen alamat semuanya ditampilkan dalam bahasa yang sama, yang dipilih dari komponen pertama.
    • Jika nama tidak tersedia dalam bahasa pilihan, API akan menggunakan kecocokan terdekat.
    • Bahasa pilihan memiliki pengaruh kecil pada kumpulan hasil yang dipilih API untuk ditampilkan, dan urutan kemunculannya. Geocoder menafsirkan singkatan secara berbeda bergantung pada bahasa, seperti singkatan untuk jenis jalan, atau sinonim yang mungkin valid dalam satu bahasa, tetapi tidak dalam bahasa lain. Misalnya, utca dan tér adalah sinonim untuk jalan dalam bahasa Hungaria.
  • region

    Kode wilayah, yang ditetapkan sebagai nilai dua karakter ccTLD ("domain level teratas"). Sebagian besar kode ccTLD identik dengan kode ISO 3166-1, dengan beberapa pengecualian. Misalnya, ccTLD Inggris Raya adalah "uk" (.co.uk) sedangkan kode ISO 3166-1-nya adalah "gb" (secara teknis untuk entitas "The United Kingdom of Great Britain and Northern Ireland").

  • reviews_no_translations

    Tentukan reviews_no_translations=true untuk menonaktifkan terjemahan ulasan; tentukan reviews_no_translations=false untuk mengaktifkan terjemahan ulasan. Ulasan ditampilkan dalam bahasa aslinya.

    Jika dihilangkan, atau diteruskan tanpa nilai, terjemahan ulasan akan diaktifkan. Jika parameter language ditentukan dalam permintaan, gunakan bahasa yang ditentukan sebagai bahasa pilihan untuk terjemahan. Jika language dihilangkan, API akan mencoba menggunakan header Accept-Language sebagai bahasa pilihan.

  • reviews_sort

    Metode pengurutan yang akan digunakan saat menampilkan ulasan. Dapat ditetapkan ke most_relevant (default) atau newest.

    • Untuk most_relevant (default), ulasan diurutkan berdasarkan relevansi; layanan akan membiaskan hasil untuk menampilkan ulasan yang awalnya ditulis dalam bahasa pilihan.
    • Untuk newest, ulasan diurutkan dalam urutan kronologis; bahasa pilihan tidak memengaruhi tata urutan.

    Google merekomendasikan agar Anda menampilkan cara ulasan diurutkan kepada pengguna akhir.

  • sessiontoken

    String acak yang mengidentifikasi sesi pelengkapan otomatis untuk tujuan penagihan.

    Sesi dimulai saat pengguna mulai mengetik kueri, dan berakhir saat pengguna memilih tempat dan panggilan ke Place Details (Lama) dilakukan. Setiap sesi dapat memiliki beberapa kueri, yang diikuti dengan satu pilihan tempat. Kunci API yang digunakan untuk setiap permintaan dalam satu sesi harus berasal dari project Konsol Google Cloud yang sama. Setelah sesi selesai, token tidak lagi valid. Aplikasi Anda harus membuat token baru untuk setiap sesi. Jika parameter sessiontoken dihilangkan, atau jika Anda menggunakan kembali token sesi, sesi tersebut dikenai biaya seolah-olah tidak ada token sesi yang diberikan (setiap permintaan ditagih secara terpisah).

    Sebaiknya ikuti panduan berikut:

    • Gunakan token sesi untuk semua sesi pelengkapan otomatis.
    • Buat token baru untuk setiap sesi. Sebaiknya gunakan UUID versi 4.
    • Pastikan kunci API yang digunakan untuk semua permintaan Place Autocomplete dan Place Details dalam satu sesi berasal dari project Konsol Cloud yang sama.
    • Pastikan untuk meneruskan token sesi yang unik untuk setiap sesi baru. Jika menggunakan token yang sama untuk lebih dari satu sesi, setiap permintaan akan ditagih satu per satu.

Contoh Place Details (Lama)

Contoh berikut meminta detail tempat berdasarkan place_id, dan menyertakan kolom name, rating, dan formatted_phone_number:

Shell

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

Ganti kunci dalam contoh ini dengan kunci API Anda sendiri agar permintaan berfungsi di aplikasi Anda.

Respons Place Details (Lama)

Respons Place Details (Lama) ditampilkan dalam format yang ditunjukkan oleh flag output dalam jalur URL permintaan.

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>

    

Respons JSON dan XML masing-masing berisi elemen berikut:

PlacesDetailsResponse

Kolom Wajib Jenis Deskripsi
required Array<string>

Dapat berisi kumpulan atribusi tentang listingan ini yang harus ditampilkan kepada pengguna (beberapa listingan mungkin tidak memiliki atribusi).

required Tempat

Berisi informasi mendetail tentang tempat yang diminta.

Lihat Tempat untuk mengetahui informasi selengkapnya.

required PlacesDetailsStatus

Berisi status permintaan, dan mungkin berisi informasi proses debug untuk membantu Anda melacak penyebab kegagalan permintaan.

Lihat PlacesDetailsStatus untuk mengetahui informasi selengkapnya.

opsional Array<string>

Jika layanan menampilkan informasi tambahan tentang spesifikasi permintaan, mungkin ada kolom info_messages tambahan dalam objek respons. Kolom ini hanya ditampilkan untuk permintaan yang berhasil. ID ini mungkin tidak selalu ditampilkan, dan kontennya dapat berubah.

Dalam respons JSON, elemen ini direpresentasikan sebagai elemen root. Dalam respons XML, elemen ini muncul sebagai elemen tingkat atas di bawah <PlaceDetailsResponse>.

PlacesDetailsStatus

Kode status yang ditampilkan oleh layanan.

  • OK yang menunjukkan bahwa permintaan API berhasil.
  • ZERO_RESULTS yang menunjukkan bahwa lokasi yang dirujuk, place_id, valid, tetapi tidak lagi merujuk ke hasil yang valid. Hal ini dapat terjadi jika tempat usaha itu tidak lagi beroperasi.
  • NOT_FOUND yang menunjukkan bahwa lokasi yang dirujuk, place_id, tidak ditemukan dalam database Places.
  • INVALID_REQUEST yang menunjukkan bahwa permintaan API memiliki format yang salah.
  • OVER_QUERY_LIMIT yang menunjukkan salah satu hal berikut:
    • Anda telah melampaui batas QPS.
    • Penagihan belum diaktifkan di akun Anda.
    • Kredit bulanan sebesar $200, atau batas penggunaan yang ditentukan sendiri, telah terlampaui.
    • Metode pembayaran yang diberikan sudah tidak valid (misalnya kartu kredit yang sudah tidak berlaku).
    Lihat FAQ Maps untuk mengetahui informasi selengkapnya tentang cara mengatasi error ini.
  • REQUEST_DENIED yang menunjukkan bahwa permintaan Anda ditolak, biasanya karena:
    • Permintaan tidak memiliki kunci API.
    • Parameter key tidak valid.
  • UNKNOWN_ERROR menunjukkan error yang tidak dikenal.

Tempat

Atribut yang mendeskripsikan tempat. Tidak semua atribut akan tersedia untuk semua jenis tempat.

Kolom Wajib Jenis Deskripsi
opsional Array<AddressComponent>

Array yang berisi komponen terpisah yang berlaku untuk alamat ini.

Lihat AddressComponent untuk mengetahui informasi selengkapnya.

opsional string

Representasi alamat tempat dalam mikroformat adr.

opsional string

Menunjukkan status operasional tempat, jika berupa bisnis. Jika tidak ada data, business_status tidak akan ditampilkan.

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
opsional boolean

Menentukan apakah bisnis mendukung Ambil di luar toko.

opsional PlaceOpeningHours

Berisi jam buka untuk tujuh hari ke depan (termasuk hari ini). Jangka waktu dimulai pada tengah malam pada tanggal permintaan dan berakhir pada pukul 23.59 enam hari kemudian. Kolom ini mencakup subkolom special_days dari semua jam, yang ditetapkan untuk tanggal yang memiliki jam khusus.

Lihat PlaceOpeningHours untuk mengetahui informasi selengkapnya.

opsional boolean

Menentukan apakah bisnis mendukung pengiriman.

opsional boolean

Menentukan apakah bisnis mendukung opsi tempat duduk di dalam atau di luar ruangan.

opsional PlaceEditorialSummary

Berisi ringkasan tempat. Ringkasan terdiri dari ringkasan tekstual, dan juga menyertakan kode bahasa untuk ringkasan ini jika berlaku. Teks ringkasan harus ditampilkan apa adanya dan tidak dapat dimodifikasi atau diubah.

Lihat PlaceEditorialSummary untuk mengetahui informasi selengkapnya.

opsional string

String yang berisi alamat tempat ini yang dapat dibaca manusia.

Sering kali alamat ini sama dengan alamat pos. Perhatikan bahwa beberapa negara, seperti Inggris Raya, tidak mengizinkan distribusi alamat pos sebenarnya karena adanya pembatasan pemberian lisensi.

Alamat yang diformat secara logis terdiri dari satu atau beberapa komponen alamat. Misalnya, alamat "111 8th Avenue, New York, NY" terdiri atas komponen berikut: "111" (nomor jalan), "8th Avenue" (rute), "New York" (kota), dan "NY" (negara bagian AS).

Jangan mengurai alamat berformat secara terprogram. Sebagai gantinya, Anda harus menggunakan komponen alamat individual, yang disertakan oleh respons API selain kolom alamat yang diformat.

opsional string

Berisi nomor telepon tempat dalam format lokalnya.

opsional Geometry

Berisi lokasi dan area pandang untuk lokasi tersebut.

Lihat Geometry untuk mengetahui informasi selengkapnya.

opsional string

Berisi URL ikon yang disarankan yang dapat ditampilkan kepada pengguna saat menunjukkan hasil ini di peta.

opsional string

Berisi kode warna heksadesimal default untuk kategori tempat.

opsional string

Berisi URL ikon yang direkomendasikan, tanpa ekstensi jenis file .svg atau .png.

opsional string

Berisi nomor telepon tempat tersebut dalam format internasional. Format internasional menyertakan kode negara dan diawali dengan tanda tambah (+). Misalnya, international_phone_number untuk kantor Google di Sydney, Australia adalah +61 2 9374 4000.

opsional string

Berisi nama yang dapat dibaca manusia untuk hasil yang ditampilkan. Untuk hasil establishment, ini biasanya adalah nama bisnis yang dikanonikalisasi.

opsional PlaceOpeningHours

Berisi jam operasional reguler.

Lihat PlaceOpeningHours untuk mengetahui informasi selengkapnya.

opsional boolean

Gunakan business_status untuk mendapatkan status operasional bisnis.

opsional Array<PlacePhoto>

Array objek foto, yang masing-masing berisi referensi ke gambar. Permintaan dapat menampilkan hingga sepuluh foto. Informasi selengkapnya tentang foto tempat dan cara menggunakan gambar di aplikasi Anda dapat ditemukan di dokumentasi Foto Tempat.

Lihat PlacePhoto untuk mengetahui informasi selengkapnya.

opsional string

Sebuah identifier tekstual yang secara unik mengidentifikasi tempat. Untuk mengambil informasi tentang tempat, teruskan ID ini di kolom place_id permintaan Places API. Untuk informasi selengkapnya tentang ID tempat, lihat ringkasan ID tempat.

opsional PlusCode

Referensi lokasi yang dienkode, yang berasal dari koordinat lintang dan bujur, yang mewakili area: 1/8000 derajat x 1/8000 derajat (sekitar 14 m x 14 m di khatulistiwa) atau lebih kecil. Plus Codes dapat digunakan sebagai pengganti alamat di tempat tanpa alamat jelas (jika bangunan tidak diberi nomor atau jalan tidak diberi nama). Lihat Open Location Code dan plus codes.

Lihat PlusCode untuk mengetahui informasi selengkapnya.

opsional angka

Tingkat harga tempat, dalam skala 0 hingga 4. Jumlah persis yang ditunjukkan oleh nilai tertentu akan bervariasi dari satu wilayah ke wilayah lainnya. Tingkat harga ditafsirkan sebagai berikut:

  • 0 Gratis
  • 1 Murah
  • 2 Sedang
  • 3 Mahal
  • 4 Sangat Mahal
opsional angka

Berisi rating tempat, dari 1,0 hingga 5,0, berdasarkan gabungan ulasan pengguna.

opsional string
opsional boolean

Menentukan apakah tempat mendukung reservasi.

opsional Array<PlaceReview>

Array JSON yang dapat berisi hingga lima ulasan. Secara default, ulasan diurutkan berdasarkan relevansi. Gunakan parameter permintaan reviews_sort untuk mengontrol pengurutan.

  • Untuk most_relevant (default), ulasan diurutkan berdasarkan relevansi; layanan akan membiaskan hasil untuk menampilkan ulasan yang awalnya ditulis dalam bahasa pilihan.
  • Untuk newest, ulasan diurutkan dalam urutan kronologis; bahasa pilihan tidak memengaruhi tata urutan.

Google merekomendasikan untuk menunjukkan kepada pengguna apakah hasil diurutkan berdasarkan most_relevant atau newest.

Lihat PlaceReview untuk mengetahui informasi selengkapnya.

opsional string
opsional Array<PlaceOpeningHours>

Berisi array entri untuk tujuh hari ke depan, termasuk informasi tentang jam buka sekunder bisnis. Jam buka sekunder berbeda dengan jam buka utama bisnis. Misalnya, restoran dapat menentukan jam drive-through atau jam pesan antar sebagai jam sekunder. Kolom ini mengisi subkolom type, yang mengambil dari daftar jenis jam buka yang telah ditentukan (seperti DRIVE_THROUGH, PICKUP, atau TAKEOUT) berdasarkan jenis tempat. Kolom ini mencakup subkolom special_days dari semua jam, yang ditetapkan untuk tanggal yang memiliki jam khusus.

Lihat PlaceOpeningHours untuk mengetahui informasi selengkapnya.

opsional boolean

Menentukan apakah tempat tersebut menyajikan bir.

opsional boolean

Menentukan apakah tempat menyajikan sarapan.

opsional boolean

Menentukan apakah tempat menyajikan brunch.

opsional boolean

Menentukan apakah tempat tersebut menyajikan makan malam.

opsional boolean

Menentukan apakah tempat tersebut menyajikan makan siang.

opsional boolean

Menentukan apakah tempat tersebut menyajikan makanan vegetarian.

opsional boolean

Menentukan apakah tempat menyajikan wine.

opsional boolean

Menentukan apakah bisnis mendukung layanan pesan bawa pulang.

opsional Array<string>

Berisi array jenis fitur yang menjelaskan hasil yang diberikan. Lihat daftar jenis yang didukung.

opsional string

Berisi URL halaman Google resmi untuk tempat ini. Halaman ini adalah halaman milik Google berisi informasi terbaik yang tersedia tentang tempat ini. Aplikasi harus menautkan ke atau menyematkan halaman ini pada setiap layar yang menampilkan hasil detail tentang tempat tersebut kepada pengguna.

opsional angka

Jumlah total ulasan, dengan atau tanpa teks, untuk tempat ini.

opsional angka

Berisi offset jumlah menit antara zona waktu tempat ini sekarang dari UTC. Misalnya, untuk tempat di Sydney, Australia saat terjadi penyesuaian waktu musim panas akan menjadi 660 (+11 jam dari UTC), dan untuk tempat di California di luar penyesuaian waktu musim panas akan menjadi -480 (-8 jam dari UTC).

opsional string

Untuk hasil fasilitas (types:["establishment", ...]) saja, kolom vicinity berisi alamat yang disederhanakan untuk tempat, termasuk nama jalan, nomor gedung, dan lokalitas, tetapi bukan provinsi/negara bagian, kode pos, atau negara.

Untuk semua hasil lainnya, kolom vicinity berisi nama fitur politik (types:["political", ...]) tersempit yang ada dalam alamat hasil.

Konten ini ditujukan untuk dibaca apa adanya. Jangan mengurai alamat berformat secara terprogram.

opsional string

Situs resmi untuk tempat ini, seperti halaman beranda bisnis.

opsional boolean

Menentukan apakah tempat tersebut memiliki pintu masuk yang dapat diakses pengguna kursi roda.

PlaceEditorialSummary

Berisi ringkasan tempat. Ringkasan terdiri dari ringkasan tekstual, dan juga menyertakan kode bahasa untuk ringkasan ini jika berlaku. Teks ringkasan harus disajikan apa adanya dan tidak dapat diubah atau dimodifikasi.

Kolom Wajib Jenis Deskripsi
opsional string

Bahasa kolom sebelumnya. Mungkin tidak selalu ada.

opsional string

Ringkasan tekstual panjang sedang tentang tempat tersebut.

PlaceOpeningHours

Objek yang menjelaskan jam buka suatu tempat.

Kolom Wajib Jenis Deskripsi
opsional boolean

Nilai boolean yang menunjukkan apakah tempat tersebut buka pada waktu saat ini.

opsional Array<PlaceOpeningHoursPeriod>

Array jangka waktu buka yang mencakup tujuh hari, mulai dari hari Minggu, dalam urutan kronologis.

Lihat PlaceOpeningHoursPeriod untuk mengetahui informasi selengkapnya.

opsional Array<PlaceSpecialDay>

Array yang berisi hingga tujuh entri yang sesuai dengan tujuh hari ke depan.

Lihat PlaceSpecialDay untuk mengetahui informasi selengkapnya.

opsional string

String jenis yang digunakan untuk mengidentifikasi jenis jam buka sekunder (misalnya, DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS). Hanya ditetapkan untuk secondary_opening_hours.

opsional Array<string>

Array string yang menjelaskan jam buka tempat dalam teks yang dapat dibaca manusia.

PlaceOpeningHoursPeriod

Kolom Wajib Jenis Deskripsi
required PlaceOpeningHoursPeriodDetail

Berisi pasangan objek hari dan waktu yang menjelaskan kapan tempat tersebut buka.

Lihat PlaceOpeningHoursPeriodDetail untuk mengetahui informasi selengkapnya.

opsional PlaceOpeningHoursPeriodDetail

Dapat berisi pasangan objek hari dan waktu yang menjelaskan kapan tempat tersebut tutup. Jika tempat selalu buka, bagian tutup tidak akan ada dalam respons. Klien dapat selalu berpatokan pada kondisi selalu-buka yang direpresentasikan sebagai jangka waktu buka yang berisi hari dengan nilai 0 dan waktu dengan nilai 0000, dan tanpa close.

Lihat PlaceOpeningHoursPeriodDetail untuk mengetahui informasi selengkapnya.

PlaceSpecialDay

Kolom Wajib Jenis Deskripsi
opsional string

Tanggal yang dinyatakan dalam format RFC3339 dalam zona waktu lokal untuk tempat tersebut, misalnya 2010-12-31.

opsional boolean

True jika ada jam buka khusus untuk hari ini. Jika true, berarti ada setidaknya satu pengecualian untuk hari ini. Pengecualian menyebabkan nilai yang berbeda muncul di subkolom current_opening_hours dan secondary_opening_hours seperti periods, weekday_text, open_now. Pengecualian berlaku untuk jam, dan jam digunakan untuk membuat kolom lainnya.

PlaceOpeningHoursPeriodDetail

Kolom Wajib Jenis Deskripsi
required angka

Angka 0–6, yang menyatakan hari-hari dalam seminggu, mulai hari Minggu. Misalnya, 2 berarti Selasa.

required string

Dapat berisi waktu dalam sehari dalam format 24 jam jjmm. Nilai berada dalam rentang 0000–2359. Waktu akan dilaporkan dalam zona waktu tempat tersebut.

opsional string

Tanggal yang dinyatakan dalam format RFC3339 dalam zona waktu lokal untuk tempat tersebut, misalnya 2010-12-31.

opsional boolean

True jika periode tertentu terpotong karena batas tujuh hari, dengan periode dimulai sebelum tengah malam pada tanggal permintaan dan/atau berakhir pada atau setelah tengah malam pada hari terakhir. Properti ini menunjukkan bahwa periode buka atau tutup dapat diperpanjang melewati batas tujuh hari ini.

PlacePhoto

Foto Tempat. Foto dapat diakses menggunakan Place Photo API menggunakan URL dalam pola berikut:

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

Lihat Foto Tempat untuk mengetahui informasi selengkapnya.

Kolom Wajib Jenis Deskripsi
required angka

Tinggi foto.

required Array<string>

Atribusi HTML untuk foto.

required string

String yang digunakan untuk mengidentifikasi foto saat Anda melakukan permintaan Foto.

required angka

Lebar foto.

PlaceReview

Ulasan tempat yang dikirimkan oleh pengguna.

Kolom Wajib Jenis Deskripsi
required string

Nama pengguna yang mengirim ulasan. Ulasan anonim diatribusikan ke "Pengguna Google".

required angka

Rating pengguna secara keseluruhan untuk tempat ini. Rating ini menggunakan bilangan bulat, berkisar dari 1 hingga 5.

required string

Waktu pengiriman ulasan dalam teks, relatif terhadap waktu saat ini.

required angka

Waktu pengiriman ulasan, diukur dalam jumlah detik sejak tengah malam, 1 Januari 1970 UTC.

opsional string

URL ke profil Local Guides Google Maps pengguna, jika tersedia.

opsional string

Kode bahasa IETF yang menunjukkan bahasa ulasan yang ditampilkan.Kolom ini hanya berisi tag bahasa utama, dan bukan tag sekunder yang menunjukkan negara atau wilayah. Misalnya, semua ulasan dalam bahasa Inggris akan diberi tag 'en', dan bukan 'en-AU' atau 'en-UK' dan seterusnya.Kolom ini kosong jika hanya ada rating tanpa teks ulasan.

opsional string

Kode bahasa IETF yang menunjukkan bahasa asli ulasan. Jika ulasan telah diterjemahkan, original_language != language.Kolom ini hanya berisi tag bahasa utama, dan bukan tag sekunder yang menunjukkan negara atau wilayah. Misalnya, semua ulasan dalam bahasa Inggris akan diberi tag 'en', dan bukan 'en-AU' atau 'en-UK' dan seterusnya.Kolom ini kosong jika hanya ada rating tanpa teks ulasan.

opsional string

URL ke foto profil pengguna, jika tersedia.

opsional string

Ulasan pengguna. Saat mengulas sebuah lokasi dengan Google Places, ulasan teks dianggap opsional. Oleh karena itu, kolom ini mungkin kosong. Perhatikan bahwa kolom ini dapat menyertakan markup HTML dasar. Misalnya, referensi entity &amp; dapat mewakili karakter ampersand.

opsional boolean

Nilai boolean yang menunjukkan apakah ulasan diterjemahkan dari bahasa asli yang digunakan untuk menulisnya.Jika ulasan telah diterjemahkan, yang sesuai dengan nilai true, Google merekomendasikan agar Anda menunjukkan hal ini kepada pengguna. Misalnya, Anda dapat menambahkan string berikut, "Diterjemahkan oleh Google", ke ulasan.