---
title: "Place"
description: "Google에서 장소 하나의 상세 정보를 가져옵니다."
---

> Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/serp/llms.txt)

```http
GET | POST /v1/google/place
```

파라미터는 `GET`의 쿼리 문자열로도, `POST`의 JSON 본문으로도 보낼 수 있습니다. 둘은 같습니다.

## 요청

```bash tab="cURL"
curl "https://gateway.apinoa.com/v1/google/place?id=0x8644ca6bc309e81b:0x1f1a903bbb66839" \
  -H "x-api-key: $APINOA_API_KEY"
```

```js tab="JavaScript"
const params = new URLSearchParams({ id: "0x8644ca6bc309e81b:0x1f1a903bbb66839" });
const res = await fetch(`https://gateway.apinoa.com/v1/google/place?${params}`, {
  headers: { "x-api-key": process.env.APINOA_API_KEY },
});
const { success, data, error } = await res.json();
```

```python tab="Python"
import os

import requests

res = requests.get(
    "https://gateway.apinoa.com/v1/google/place",
    params={"id": "0x8644ca6bc309e81b:0x1f1a903bbb66839"},
    headers={"x-api-key": os.environ["APINOA_API_KEY"]},
)
body = res.json()
```

## 파라미터

| Parameter | Type | Required | Notes |
|---|---|---|---|
| `id` | string |  | The place's id, as `places` returns it. |
| `lang` | string |  | Interface language. |
| `url` | string |  | A Google Maps place URL. |

The same parameters, and every response type, are in the OpenAPI document: https://apinoa.com/openapi.json

## 응답

`data`에 [`Place`](/docs/api-reference/serp/response-schema#place)를 돌려줍니다. 실제 응답을 줄인 것입니다. 배열은 앞쪽 항목만 남기고 긴 텍스트는 잘랐습니다.

```json
{
  "success": true,
  "data": {
    "id": "0x8644ca6bc309e81b:0x1f1a903bbb66839",
    "name": "Epoch Coffee",
    "url": "https://www.google.com/maps/preview/place/Epoch+Coffee,+221+W+N+Loop+Blvd,+Austin,+TX+78751/@30.3186037,-97.7245402,3444a,13.1y/data=!4m2!3m1!1s0x8644ca6bc309e8…",
    "address": {
      "full": "221 W N Loop Blvd, Austin, TX 78751",
      "street": "221 W N Loop Blvd",
      "city": "Austin",
      "region": "TX",
      "postalCode": "78751",
      "country": "US"
    },
    "coordinates": {"lat": 30.318603699999997, "lng": -97.72454019999999},
    "categories": ["Coffee shop"],
    "rating": 4.5,
    "reviewCount": 2534,
    "phone": "(512) 454-3762",
    "website": "http://www.epochcoffee.com/",
    "hours": [{"day": "Thursday", "hours": "Open 24 hours"}, {"day": "Friday", "hours": "Open 24 hours"}],
    "photos": [
      "https://lh3.googleusercontent.com/grass-cs/AABkmLf8MEzqjutCui37zmqNvXY83Pca5LQ_lkwbIzVGenHSqnuLI_Ik30zwgz1Awup0_iDR4V9H7mtV_8aijxQ8AFP-Y-hD1_ht7ogdduCfc_WLN64AT…",
      "https://lh3.googleusercontent.com/grass-cs/AABkmLfLrOLlfLpkdnFppSN1k1TI7tV6OWF-xDiQkpFLqZnWhXweai7GzvrOlD-tnNT7WECPmHVyFhvMJ1F8Q-ZW_Pfb3drJVOHG_2vjuFcXtAqPD9L__…"
    ],
    "attributes": [
      {"group": "Accessibility", "label": "Wheelchair accessible entrance"},
      {"group": "Accessibility", "label": "Wheelchair accessible parking lot"}
    ],
    "status": "open",
    "description": "Cool, vibrant small-chain cafe featuring nibbles, tea & carefully brewed espresso drinks.",
    "ext": {
      "placeId": "ChIJG-gJw2vKRIYROWi2uwOp8QE",
      "kgmid": "/g/1v76_180",
      "timeZone": "America/Chicago",
      "summary": "Hip coffee shop with light bites",
      "plusCode": {"global": "8624879G+C5", "compound": "879G+C5 Austin, Texas"},
      "areas": ["Americas", "Southern United States"],
      "owner": {
        "name": "Epoch Coffee (Owner)",
        "image": "https://lh5.googleusercontent.com/-WzsTjK0vgDQ/AAAAAAAAAAI/AAAAAAAAAAA/uanMPnqDLak/s44-p-k-no-ns-nd/photo.jpg"
      },
      "ratingHistogram": {"1": 84, "2": 60, "3": 149, "4": 462, "5": 1779},
      "reviewHighlights": [
        {
          "text": "The atmosphere is homey with mix matched furniture and funky decor.",
          "authorUrl": "https://www.google.com/maps/contrib/102913306226507508797?hl=en-US",
          "authorImage": "https://lh3.googleusercontent.com/a/ACg8ocK5EThT9DL2VwXLsgfvtdMFUTBc3PuaIs7oflgrtRY-u1ICqNA=s40-k-cc-rp-mo",
          "reviewerId": "102913306226507508797",
          "reviewId": "Ci9DQUlRQUNvZENodHljRjlvT2pOYVN6aHVhblppV0hNdFltTjRZWEZoVFdkRE1GRRAB"
        },
        {
          "text": "Classic Austin vibes with awesome prices and super friendly/ cool staff.",
          "authorUrl": "https://www.google.com/maps/contrib/100932097603579677275?hl=en-US",
          "authorImage": "https://lh3.googleusercontent.com/a/ACg8ocI598pfuVwBh_mkX_eCkPx1MjjrtWs16XS2FK2BaIB_yXZBAQ=s40-k-cc-rp-mo",
          "reviewerId": "100932097603579677275",
          "reviewId": "ChdDSUhNMG9nS0VJQ0FnSURBNkpmY3BRRRAB"
        }
      ],
      "topics": [{"label": "outdoor seating", "mentions": 71}, {"label": "study spot", "mentions": 20}],
      "reviews": [
        {
          "id": "Ci9DQUlRQUNvZENodHljRjlvT2tSS1ZtOUdNMlZ6Wm05eVowWnFXa2RKVFdOdVNHYxAB",
          "author": "Naomi • Intentionally Crafted",
          "rating": 5,
          "body": "A friend recommended Epoch Coffee on North Loop, so yesterday morning I made it the destination for my walk from East Austin—and I’m so glad I did!\n\nNestled nea…",
          "date": "2026-08-11T15:58:45.622Z",
          "language": "en",
          "images": [
            "https://lh3.googleusercontent.com/grass-cs/AABkmLerlYc1H21T5s0eRV7P6uroxN8CRED2zWk0KWFbIDxJx1Y7UjmKISAKFm-Y3QFcnINhD-nvGhkIq6zODbm4b1gs3I2jsgnGjkl1cvlTyGE3B7LCd…"
          ],
          "ext": {
            "dateText": "2 months ago",
            "source": "Google",
            "url": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tSS1ZtOUdNMlZ6Wm05eVowWnFXa2RKVFdOdVNHYxAB!2m1!1s0x0:0x1f1a903bbb66839!3m…",
            "authorUrl": "https://www.google.com/maps/contrib/104340167270615172538?hl=en-US",
            "authorImage": "https://lh3.googleusercontent.com/a-/ALV-UjVf_oseTFdaaXHxa7GWOkwHt9yWcYzESPE_-bMx2ojJbVdthaA=s120-c-rp-mo-ba12-br100",
            "reviewerId": "104340167270615172538",
            "authorReviewCount": 66,
            "authorPhotoCount": 395,
            "authorBadge": "Local Guide · 66 reviews",
            "answers": [{"question": "Order type", "answer": "Dine in"}]
          }
        },
        {
          "id": "Ci9DQUlRQUNvZENodHljRjlvT2pOYVN6aHVhblppV0hNdFltTjRZWEZoVFdkRE1GRRAB",
          "author": "Briana N.",
          "rating": 5,
          "body": "First impression they have friendly and welcoming baristas. Great menu with variety. I got a lemonade with peach syrup and hibiscus tea (so delicious!). My part…",
          "date": "2026-06-27T22:49:37.010Z",
          "language": "en",
          "images": [
            "https://lh3.googleusercontent.com/grass-cs/AABkmLdH5Ktkx_Dw3iqNRpafPbLYNIbb7mJq0M8v_sN2p2qAT7_46mhrvuKnB6SCeE_MZSuK0WFF9fhziGGxFhLcLZHGIV-4v79RXnjY8CsbDQk5Xp3R3…"
          ],
          "ext": {
            "dateText": "4 months ago",
            "source": "Google",
            "url": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pOYVN6aHVhblppV0hNdFltTjRZWEZoVFdkRE1GRRAB!2m1!1s0x0:0x1f1a903bbb66839!3m…",
            "authorUrl": "https://www.google.com/maps/contrib/102913306226507508797?hl=en-US",
            "authorImage": "https://lh3.googleusercontent.com/a/ACg8ocK5EThT9DL2VwXLsgfvtdMFUTBc3PuaIs7oflgrtRY-u1ICqNA=s120-c-rp-mo-ba12-br100",
            "reviewerId": "102913306226507508797",
            "authorReviewCount": 81,
            "authorPhotoCount": 71,
            "authorBadge": "Local Guide · 81 reviews",
            "answers": [{"question": "Price per person", "answer": "$1–10"}]
          }
        }
      ]
    },
    "lang": "en",
    "photoCount": 838,
    "statusText": "Open 24 hours",
    "neighborhood": "North Loop",
    "reviewsUrl": "https://search.google.com/local/reviews?placeid=ChIJG-gJw2vKRIYROWi2uwOp8QE&authuser=0&hl=en&gl=US"
  }
}
```

## 에러

| 상태 | 코드 | 의미 |
|---|---|---|
| 400 | `INVALID_PARAMS` | 파라미터가 없거나, 알 수 없거나, 범위를 벗어났거나, 이 엔진이 받지 않는 값입니다. 메시지에 이름이 나옵니다. |
| 401 | `UNAUTHORIZED` | `x-api-key` 헤더가 없거나, 폐기되었거나 알 수 없는 키입니다. |
| 402 | `INSUFFICIENT_BALANCE` | 잔액이 이 호출 비용에 모자랍니다. 대시보드에서 충전하세요. |
| 404 | `NOT_FOUND` | 장소가 없습니다. |
| 429 | `MARKETPLACE_SATURATED` | 동시 호출이 너무 많습니다. `Retry-After` 초만큼 기다린 뒤 다시 시도하세요. |
| 502 | `UPSTREAM_ERROR` | 엔진이 쓸 수 없는 응답을 보냈습니다. 간격을 두고 다시 시도하세요. |
| 503 | `SERVICE_UNAVAILABLE` | 일시적인 장애입니다. 간격을 두고 다시 시도하세요. |

모든 코드는 [Errors](/docs/errors)에 있습니다. 실패한 호출은 과금되지 않습니다.

## 가격

**Price** $0.0012 per call. [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day.

## 참고

- `places`가 돌려준 `id`를 넘기거나, 장소의 지도 링크를 `url`로 넘깁니다.