장소 세부정보 (신규)

플랫폼 선택: Android iOS JavaScript 웹 서비스

장소 ID가 있으면 다음 작업을 할 수 있습니다. 특정 시설에 대한 추가 세부정보를 요청하거나 사용자의 관심을 끄는 장소 세부정보 (신규) 합니다. Place Details (New) 요청은 표시된 장소에 대해 더 포괄적인 정보를 반환합니다. 전체 주소, 전화번호, 사용자 평가 및 리뷰 등이 포함됩니다.

장소 ID를 가져오는 방법에는 여러 가지가 있습니다. 이 옵션은 다음과 같습니다.

API 탐색기를 사용하면 실시간 요청을 하여 API 및 API 옵션:

실습

Place Details (New) 요청

Place Details 요청은 다음과 같은 형식의 HTTP GET 요청입니다.

https://places.googleapis.com/v1/places/PLACE_ID

GET 요청을 수행합니다. 예를 들면 다음과 같습니다.

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

또는 cURL 명령어에서 다음을 실행합니다.

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Place Details (New) 응답

Place Details (New)는 <ph type="x-smartling-placeholder"></ph> JSON 객체 응답 응답에서 각 항목의 의미는 다음과 같습니다.

  • 응답은 Place 드림 객체를 지정합니다. Place 객체에는 있습니다.
  • 요청에 전달된 FieldMask는 필드 목록을 지정합니다. Place 객체에서 반환됩니다.

전체 JSON 객체는 다음과 같은 형식입니다.

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

필수 매개변수

  • FieldMask

    응답 필드 마스크와 같습니다. URL 매개변수를 사용하여 응답 필드 마스크를 메서드에 전달 $fields 또는 fields, 또는 HTTP 헤더 사용 X-Goog-FieldMask입니다. 응답에는 반환된 필드의 기본 목록이 없습니다. 필드 마스크를 생략하면 메서드가 오류를 반환합니다.

    필드 마스킹은 불필요한 데이터이므로 불필요한 처리 시간과 있습니다.

    반환할 장소 데이터 유형의 쉼표로 구분된 목록을 지정합니다. 예를 들어 를 사용하여 장소의 표시 이름과 주소를 가져올 수 있습니다.

    X-Goog-FieldMask: displayName,formattedAddress

    *를 사용하여 모든 필드를 검색합니다.

    X-Goog-FieldMask: *

    다음 필드 중 하나 이상을 지정합니다.

    • 다음 필드는 Place Details (IDs Only) SKU를 트리거합니다.

      attributions, id, name*님,
      photos
      * name 필드에 리소스 이름 장소가 포함됨 형식은 places/PLACE_ID입니다. displayName을 사용하여 장소의 텍스트 이름에 액세스합니다.

    • 다음 필드는 Place Details (Location Only) SKU를 트리거합니다.

      addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

    • 다음 필드는 Place Details (Basic) SKU를 트리거합니다.

      accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, subDestinations, utcOffsetMinutes

    • 다음 필드는 Place Details (Advanced) SKU를 트리거합니다.

      currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

    • 다음 필드는 Place Details (Preferred) SKU를 트리거합니다.

      allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions, fuelOptions, goodForChildren, goodForGroups, goodForWatchingSports, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, reservable, restroom, reviews, servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine, takeout

  • placeId

    장소를 고유하게 식별하는 텍스트 식별자로 텍스트 검색 (신규) 또는 주변 검색 (신규). 장소 ID에 대한 자세한 내용은 다음을 참고하세요. 장소 ID 개요

    places/PLACE_ID 문자열은 장소라고도 합니다. 리소스 이름. Place Details (New)의 응답에서 주변 검색 (신규) 및 텍스트 검색 (신규) 요청의 경우 이 문자열은 응답의 name 필드에 포함됩니다. 독립형 장소 ID는 응답의 id 필드에 포함됩니다.

선택적 매개변수

  • languageCode

    결과를 반환할 때 사용하는 언어입니다.

    • 자세한 내용은 지원되는 언어 목록을 확인하세요. Google은 자주 이 목록은 완전하지 않을 수 있습니다.
    • languageCode가 제공되지 않으면 API의 기본값은 en입니다. 만약 잘못된 언어 코드를 지정하면 API가 INVALID_ARGUMENT 오류를 반환합니다.
    • API는 다음과 같이 읽을 수 있는 상세 주소를 제공하기 위해 최선을 다합니다. 이 문제를 해결할 수 있습니다. 이 목표를 달성하기 위해 주소를 현지 언어로 읽을 수 있으며, 읽을 수 있는 스크립트로 음역하고 사용자가 선호하는 언어를 관찰합니다. 기타 모든 항목 주소는 기본 언어로 반환됩니다. 주소 구성요소는 모두 동일한 언어로 반환되며 이는 첫 번째 구성요소를 사용합니다.
    • 기본 언어로 이름을 사용할 수 없는 경우 API는 가장 근접한 값을 찾습니다.
    • 선호 언어는 사용자가 선호하는 결과 세트에 약간의 영향을 미칩니다. API가 반환하기로 선택한 값과 반환되는 순서를 지정합니다. 이 지오코더는 언어에 따라 약어를 다르게 해석하지만 예를 들어 도로 유형의 약어나 한 언어에서는 유효하지만 다른 언어에서는 유효하지 않습니다.

  • regionCode

    응답 형식을 지정하는 데 사용되는 지역 코드로, <ph type="x-smartling-placeholder"></ph> 2자리 CLDR 코드 값을 제공합니다. 기본값은 없습니다.

    응답의 formattedAddress 필드의 국가 이름이 regionCode인 경우 국가 코드가 formattedAddress에서 생략됩니다. 이 매개변수는 항상 국가를 포함하는 adrFormatAddress에는 영향을 미치지 않습니다. 이름 또는 shortFormattedAddress(포함되지 않음)에 있어야 합니다.

    대부분의 CLDR 코드는 ISO 3166-1 코드와 동일하지만 몇 가지 주목할 만한 예외가 있습니다 예를 들어 영국의 ccTLD는 'uk' (.co.uk), ISO 3166-1 코드는 'gb'입니다. (기술적으로 '영국 및 북아일랜드'의 법인 소유입니다. 매개변수는 관련 법률에 따라 결과에 영향을 미칠 수 있습니다.

  • sessionToken

    세션 토큰은 자동 완성을 추적하는 사용자 생성 문자열입니다. (신규) 통화를 '세션'으로 집계 자동 완성 (신규)은 세션 토큰을 사용하여 사용자 자동 완성 검색의 쿼리 및 장소 선택 단계를 개별 세션으로 그룹화 사용할 수 없습니다. 세션 토큰이 장소 세부정보로 전달됨 (신규) 자동 완성 (신규) 호출 이후의 모든 호출 자세한 내용은 세션 토큰.

장소 세부정보 예

다음 예는 placeId:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

X-Goog-FieldMask 헤더는 응답 id,displayName 데이터 필드가 포함됩니다. 응답은 다음과 같은 형식입니다.

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

추가 정보를 반환하려면 필드 마스크에 데이터 유형을 더 추가하세요. 예를 들어 formattedAddress,plusCode를 추가하여 주소와 Plus Code를 응답:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

이제 응답은 다음과 같은 형식입니다.

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

사용해 보기

API 탐색기를 사용하면 샘플 요청을 수행하여 API 및 API 옵션에 익숙해지실 수 있습니다.

요청하려면 다음 안내를 따르세요.

  1. API 아이콘 API 탐색기를 펼칩니다.을 선택합니다. 을 클릭합니다.
  2. 필요한 경우 name 매개변수를 다음과 같이 설정합니다. 
    places/PLACE_ID
  3. 필요한 경우 표준 매개변수 표시를 펼치고 fields 매개변수 필드 마스크에 추가합니다.
  4. 실행 버튼을 선택합니다. 팝업에서 원하는 계정을 선택합니다. 사용하여 요청을 수행합니다.

  5. API 탐색기 패널에서 펼치기 아이콘을 선택합니다. API 탐색기를 펼칩니다.: API 탐색기 창을 펼칩니다.