장소 아이콘은 다양한 유형의 장소(예: 커피숍, 도서관, 박물관)를 나타냅니다. PNG 형식의 아이콘 URL을 요청할 수도 있습니다.
을 해당하는 아이콘 배경색으로 지정하며,
현재 장소,
및 Place Details(New)(장소 세부정보)
요청을 처리합니다
장소의 아이콘 이미지와 배경 색상을 요청하려면
다음 필드를 포함해야 합니다.
Place.Field.ICON_MASK_URL
Place.Field.ICON_BACKGROUND_COLOR
다음 예는 현재 장소 또는 장소 세부정보 요청의 아이콘 이미지와 배경 색상을 사용하는 방법을 보여줍니다.
Kotlin
// Set the image view's background color to match the place's icon background colorimageView.setBackgroundColor(place.iconBackgroundColor)// Fetch the icon using Glide and set the result in the image viewGlide.with(this).load(place.iconUrl).into(imageView)
자바
// Set the image view's background color to match the place's icon background colorimageView.setBackgroundColor(place.getIconBackgroundColor());// Fetch the icon using Glide and set the result in the image viewGlide.with(this).load(place.getIconUrl()).into(imageView);
이 예에서는 Glide
이미지 로드 라이브러리를 사용할 수 있지만 원하는 이미지 로드 라이브러리를 사용할 수도 있습니다.
필드
각 장소 아이콘에는 다음과 같은 필드가 포함됩니다.
ICON_MASK_URL는 색상이 지정되지 않은 PNG 아이콘의 기본 URL을 반환합니다.
ICON_BACKGROUND_COLOR는 장소 카테고리의 기본 색상 코드를 반환합니다.
장소 아이콘 및 배경색 요청
다음 표에는 사용 가능한 모든 장소 아이콘이 카테고리별로 나와 있습니다. 기본적으로 이러한 장소 아이콘은 검은 글리프로 표시됩니다. 아이콘 배경 색상은 장소의 카테고리에 따라 결정됩니다.
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003ePlace icons, available in PNG format, represent various place types like restaurants and libraries, accessible through Current Place and Place Details requests.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve the icon URL using \u003ccode\u003ePlace.Field.ICON_MASK_URL\u003c/code\u003e and the background color using \u003ccode\u003ePlace.Field.ICON_BACKGROUND_COLOR\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe icon URL is a base URL for a non-colored PNG that is overlaid on a background color representing the place's category, like #FF9E67 for food and drink.\u003c/p\u003e\n"],["\u003cp\u003eCode examples are provided in Kotlin and Java to demonstrate fetching and displaying the icon and background color using an image loading library like Glide.\u003c/p\u003e\n"],["\u003cp\u003eA comprehensive table showcases available place icons categorized by type, along with their corresponding background colors.\u003c/p\u003e\n"]]],["Place icons, indicating different types of locations, can be accessed via URLs in PNG format along with their background colors. Requests for icons and colors require the `ICON_MASK_URL` and `ICON_BACKGROUND_COLOR` fields. The icon URL, obtained through `Place.Field.ICON_MASK_URL`, should be consistently referenced due to potential changes. `ICON_BACKGROUND_COLOR` returns the category's default color. The document then details various place categories and their associated icons and background colors. For example food and drink has the background color #FF9E67.\n"],null,["# Place Icons\n\nSelect platform: [Android](/maps/documentation/places/android-sdk/icons \"View this page for the Android platform docs.\") [iOS](/maps/documentation/places/ios-sdk/icons \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/place-icons \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/places/web-service/icons \"View this page for the Web Service platform docs.\")\n\nPlace icons indicate the various types of places (for example coffee shops,\nlibraries, and museums). You can request URLs for icons in PNG format, as well\nas the corresponding icon background color, with\n[Current Place](/maps/documentation/places/android-sdk/current-place),\nand [Place Details (New)](/maps/documentation/places/android-sdk/details-place)\nrequests.\n\nTo request an icon image and background color for a place, include the\nfollowing fields in your request:\n\n- `Place.Field.ICON_MASK_URL`\n- `Place.Field.ICON_BACKGROUND_COLOR`\n\nThe following examples demonstrate using the icon image and background color\nfrom a Current Place or Place Details request: \n\n### Kotlin\n\n```kotlin\n // Set the image view's background color to match the place's icon background color\n imageView.setBackgroundColor(place.iconBackgroundColor)\n\n // Fetch the icon using Glide and set the result in the image view\n Glide.with(this)\n .load(place.iconUrl)\n .into(imageView)\n\n \n```\n\n### Java\n\n```java\n // Set the image view's background color to match the place's icon background color\n imageView.setBackgroundColor(place.getIconBackgroundColor());\n\n // Fetch the icon using Glide and set the result in the image view\n Glide.with(this)\n .load(place.getIconUrl())\n .into(imageView);\n\n \n```\nThis example uses the [Glide](https://github.com/bumptech/glide) image loading library, but you can use the image loading library of your choice. Icon URLs may change, so be sure to always use `Place.Field.ICON_MASK_URL` to look up the URL for an icon.\n\nFields\n------\n\nEach Place icon contains these fields:\n\n- `ICON_MASK_URL` returns the base URL for a non-colored PNG icon.\n- `ICON_BACKGROUND_COLOR` returns the default color code for the place's category.\n\nPlace icon and background color requests\n----------------------------------------\n\nThe following tables show all of the available place icons by category. By\ndefault these display with a black glyph. The icon background color\nis dictated by the place's category.\n\n| **Place category: Food and drink** (icon background color #FF9E67) ||||\n|--------------------------------------------------------------------|-----------------------------------------|----------------------|------------------|\n| Bar, Night club | Cafe | Restaurant, Bakery |\n| Books, Clothing, Electronics, Jewelry, Shoes, Shopping center/Mall | Convenience store | Grocery, Supermarket | Pharmacy |\n| ATM | Bank | Gas | Lodging |\n| Post office |\n| Aquarium, Tourist | Golf | Historic | Movie |\n| Museum | Theater |\n| Airport | Bus, rideshare, taxi | Train/Rail |\n| Cemetery | Civic building | Library | Monument |\n| Parking | School (primary, secondary, university) | Worship (Christian) |\n| Worship (Hindu) | Worship (Islam) | Worship (Jain) | Worship (Jewish) |\n| Worship (Sikh) | Generic business |\n| Boating | Camping | Park | Stadium |\n| Zoo |\n| Hospital | Police |"]]
