Android용 Places SDK (기존)에서 Place.getName() 메서드는 장소의 이름을 포함하는 텍스트 문자열을 반환합니다. 장소 이름으로 Place 객체를 채우려면 장소 세부정보 요청의 필드 목록에 Place.Field.DISPLAY_NAME을 포함해야 합니다.
이제 Place 객체에 이름 문자열의 언어 코드가 포함됩니다. 언어 코드로 Place 객체를 채우려면 다음 단계를 따라야 합니다.
요청의 필드 목록에 Place.Field.DISPLAY_NAME을 포함합니다.
이 값은 Place 객체에 장소 이름과 언어 코드를 모두 포함하도록 응답을 구성합니다.
Android용 Places SDK (신규)는 지역 코드 요청 매개변수를 장소 세부정보에 추가합니다. 지역 코드는 응답의 형식을 지정하는 데 사용되며 두 자리 CLDR 코드 값으로 지정됩니다. 이 매개변수는 검색 결과에 편향을 줄 수도 있습니다. 기본값은 없습니다. 지역 코드를 설정하려면 새 SDK를 사용 설정해야 합니다.
응답의 주소 필드에 있는 국가 이름이 지역 코드와 일치하면 주소에서 국가 코드가 생략됩니다.
대부분의 CLDR 코드는 ISO 3166-1 코드와 동일하지만 일부 주목할 만한 예외가 있습니다.
예를 들어 영국의 ccTLD는 'uk' (.co.uk)이지만 ISO 3166-1 코드는 'gb' (기술적으로 '그레이트브리튼 및 북아일랜드 연합 왕국' 법인용)입니다. 이 매개변수는 관련 법규에 따라 결과에 영향을 미칠 수 있습니다.
[null,null,["최종 업데이트: 2025-08-30(UTC)"],[],[],null,["# Migrate to Place Details (New)\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\n\u003cbr /\u003e\n\n| This feature requires that you enable Places API (New), the next generation of the Places API. For more information, see [Enable APIs](/maps/documentation/places/android-sdk/legacy/cloud-setup#enabling-apis).\n\n\u003cbr /\u003e\n\nPlaces SDK for Android supports [Place Details (Legacy)](/maps/documentation/places/android-sdk/details-places).\nIf you are familiar with the Places SDK for Android (Legacy), [Place Details (New)](/maps/documentation/places/android-sdk/details-places)\nmakes the following changes:\n\n- Uses a new pricing model. For pricing information for all APIs, see [Places SDK for Android\n (New)](/maps/documentation/places/android-sdk/usage-and-billing#pricing-new).\n\n- You must initialize your app by calling the\n [`Places.initializeWithNewPlacesApiEnabled()`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/Places#initializeWithNewPlacesApiEnabled(android.content.Context,%20java.lang.String))\n method. For more information on selecting the Places API service, see\n [Set up your Google Cloud project](/maps/documentation/places/android-sdk/legacy/cloud-setup).\n\n- Field masking is required. You must specify which fields you want returned\n in the response. There is no default list of returned fields. If you omit\n this list, the methods return an error.\n\nThe following sections describe additional changes.\n\nAccess new place types\n----------------------\n\nEach place can have one or more *type* values associated with it. The\nPlaces SDK for Android version 3.3.0 and later adds many new type\nvalues. For the complete list, see [Expanded place\ntypes](/maps/documentation/places/android-sdk/legacy/choose-sdk#expanded_place_types).\n\nThe\n[`Place.getPlaceTypes()`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place#getPlaceTypes())\nmethod returns the type values as a list of string values. The values returned\ndepend on your version of the Places SDK for Android:\n\n- **Places SDK for Android (New)** : Returns the strings defined by\n Table A and Table B shown on [Place Types (New)](/maps/documentation/places/android-sdk/legacy/place-types), including all\n the added place types added in version 3.3.0.\n\n- **Places SDK for Android** : Returns the enums defined by\n `Place.Types`, which does not include the new types added in version 3.3.0\n and later.\n\nAccess place reviews\n--------------------\n\nThe Places SDK for Android (New) adds the\n[`Review`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Review)\nclass, which contains a review of a place. The `Place` object can contain up to\nfive reviews.\n\nThe `Review` class can also contain an attribution and an author attribution. If\nyou display the review in your app, then you must also display any attribution\nor author attribution. For more information, see [Display a\nreview](/maps/documentation/places/android-sdk/legacy/policies#reviews).\n\nFor more information, see the documentation on\n[attributions](/maps/documentation/places/ios-sdk/policies#other_attribution_requirements).\n\nAccess place name language code\n-------------------------------\n\nIn the Places SDK for Android (Legacy),\n[`Place.getName()`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place#public-abstract-string-getname)\nmethod returns a text string containing the name of a place. To populate the\n`Place` object with the place name, you must include the\n`Place.Field.DISPLAY_NAME` in the field list of the place details request.\n\nThe `Place` object now contains the language code for the name string. To\npopulate the `Place` object with language code, you must:\n\n1. Include the `Place.Field.DISPLAY_NAME` in the field list of the request.\n This value configures response to include both the place name and language\n code in the `Place` object.\n\n2. Call\n [`PlacesClient.fetchPlace()`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/net/PlacesClient#fetchPlace(com.google.android.libraries.places.api.net.FetchPlaceRequest)).\n `PlacesClient.findCurrentPlace()` does not support the language code field.\n\n3. Use the [`Place.getNameLanguageCode()`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place#public-abstract-string-getnamelanguagecode)\n method to access the language code field in the `Place` object.\n\nSet region code\n---------------\n\nPlaces SDK for Android (New) adds the region code request parameter to\nPlace Details. The region code is used to format the response, specified as a\n[two-character CLDR code](https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html)\nvalue. This parameter can also have a bias effect on the search results. There\nis no default value. You must enable the new SDK to set the region code.\n\nIf the country name of the address field in the response matches the region\ncode, the country code is omitted from address.\n\nMost CLDR codes are identical to ISO 3166-1 codes, with some notable exceptions.\nFor example, the United Kingdom's ccTLD is \"uk\" (.co.uk) while its ISO 3166-1\ncode is \"gb\" (technically for the entity of \"The United Kingdom of Great Britain\nand Northern Ireland\"). The parameter can affect results based on applicable\nlaw.\n\nExample request\n---------------\n\nFor a complete example, see [Place Details\n(New)](/maps/documentation/places/android-sdk/details-place)."]]
