View a markdown version of this page

특정 위치에서 인근을 검색하는 방법 - Amazon Location Service
잠재적 사용 사례예제

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

특정 위치에서 인근을 검색하는 방법

SearchNearby API를 사용하면 특정 텍스트를 입력하지 않고도 근처의 모든 장소 및 관심 지점(POI)을 쿼리할 수 있습니다. 사용자는 이 API를 사용하여 주변 지역을 탐색하고 POI를 검색하는 등의 작업을 수행할 수 있습니다. 디바이스의 위치, IP 기반 위치 또는 맵 뷰포트 중심을 나타낼 수 있는 QueryPosition이 필요합니다. 또는 사용자가 도시 또는 장소를 지정하여 해당 위치의 지리 좌표에 따라 결과를 편향시킬 수 있습니다.

잠재적 사용 사례

  • 가까운 POI 탐색: 현재 위치 근처의 모든 관심 지점을 봅니다.

  • 가까운 장소 탐색: 지정된 위치 근처의 모든 위치 또는 장소를 봅니다.

예제

이 예제에서는 위도가 25.26951이고 경도가 55.30884인 두바이의 특정 위치에서 검색을 수행합니다.

Sample request
{
    "QueryPosition": [
        55.30884,
        25.26951
    ]
}
Sample response
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointOfInterest",
            "Title": "هما",
            "Address": {
                "Label": "هما, شارع مستشفى آل مكتوم, نايف دبي, الإمارات العربية المتحدة",
                "Country": {
                    "Code2": "AE",
                    "Code3": "ARE",
                    "Name": "الإمارات العربية المتحدة"
                },
                "SubRegion": {
                    "Name": "دبي"
                },
                "Locality": "دبي",
                "District": "نايف",
                "Street": "شارع مستشفى آل مكتوم",
                "StreetComponents": [
                    {
                        "BaseName": "مستشفى آل مكتوم",
                        "Type": "شارع",
                        "TypePlacement": "BeforeBaseName",
                        "TypeSeparator": " ",
                        "Language": "ar"
                    }
                ]
            },
            "Position": [
                55.30884,
                25.26951
            ],
            "Distance": 0,
            "Categories": [
                {
                    "Id": "department_store",
                    "Name": "Department Store",
                    "LocalizedName": "مول تجاري",
                    "Primary": true
                }
            ],
            "BusinessChains": [
                {
                    "Name": "HEMA",
                    "Id": "HEMA"
                }
            ]
        },
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "Locality",
            "Title": "دبي, الإمارات العربية المتحدة",
            "Address": {
                "Label": "دبي, الإمارات العربية المتحدة",
                "Country": {
                    "Code2": "AE",
                    "Code3": "ARE",
                    "Name": "الإمارات العربية المتحدة"
                },
                "SubRegion": {
                    "Name": "دبي"
                },
                "Locality": "دبي"
            },
            "Position": [
                55.30884,
                25.26951
            ],
            "Distance": 0,
            "MapView": [
                54.64906,
                24.62308,
                55.7371,
                25.36995
            ]
        }
    ]
}
cURL
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryPosition": [
        55.30884,
        25.26951
    ],
    "MaxResults": 2
}'
AWS CLI
aws geo-places search-nearby --key ${YourKey} \
--query-position 55.30884 25.26951 \
--max-results 2