기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
장소 ID 사용
장소를 검색하면 결과 목록이 반환됩니다. 대부분의 결과에는 해당 결과에 대한 PlaceId
이 포함됩니다. GetPlace
작업에서 PlaceId
을 사용하여 해당 장소에 대한 정보(이름, 주소, 위치 또는 기타 세부 정보 포함)를 반환할 수 있습니다.
참고
를 SearchPlaceIndexForSuggestions사용하면 모든 데이터 소스로 만든 모든 장소 색인에 대한 PlaceId
결과가 반환됩니다. SearchPlaceIndexForText를 SearchPlaceIndexForPosition사용하면 사용된 데이터 소스가 PlaceId
HERE인 경우에만 a를 반환합니다.
PlaceId
각각은 자신이 참조하는 장소를 고유하게 정의하지만, 시간이 지남에 따라 그리고 상황에 따라 한 장소에 여러 개의 PlaceId
가 있을 수 있습니다. 다음 규칙은 PlaceId
의 고유성과 수명을 설명합니다.
-
PlaceId
회신되는 호출은 사용자 AWS 계정, AWS 지역,PlaceIndex
리소스의 데이터 공급자별로 다릅니다.GetPlace
이 세 가지 속성이 를 생성한 원래 호출과 일치하는 경우에만 결과를 찾을 수PlaceId
있습니다. -
장소에 대한 데이터가 변경되면 해당 장소에 대한
PlaceId
도 변경됩니다. 예를 들어, 추천하는 사업체가 위치를 옮기거나 이름을 변경하는 경우. -
반복되는 검색 호출에서 반환되는
PlaceId
은 백엔드 서비스가 업데이트할 때 변경될 수 있습니다. 이전PlaceId
은 계속 검색되지만 새로 검색을 호출하면 다른 ID가 반환될 수 있습니다.
PlaceId
은 문자열입니다. PlaceId
의 길이에는 특별한 제한이 없습니다. 다음은 유효한 PlaceId
의 예입니다.
AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ
데이터가 변경된 장소(예: 영업이 중단된 사업장)에 대해 PlaceId
로 GetPlace
을 호출하면 404
, ResourceNotFound
오류가 발생합니다. a를 GetPlace
사용하여 호출하면 유효하지 않거나 다른 호출과 같이 컨텍스트에 맞지 PlaceId
않는 것으로 호출하면 AWS 계정400
, ValidationException
오류가 반환됩니다.
PlaceID는 후속 요청에서 사용할 수 있지만 PlaceID는 영구적인 식별자가 아니므로 연속적인 API 호출 간에 ID가 변경될 수 있습니다. 각 데이터 공급자에 대한 다음 PlaceID 동작을 참조하십시오.
-
Esri: 장소 ID는 최소한 분기마다 변경됩니다. 이러한 변경이 적용되는 일반적인 기간은 3월, 6월, 9월, 12월입니다. 장소 ID는 일반적인 분기별 변경 시에도 변경될 수 있지만 그 빈도는 훨씬 줄어들 것입니다.
-
HERE: 데이터를 최신 상태로 유지하려면 데이터를 일주일 이상 캐시하지 않는 것이 좋습니다. 릴리스 이후 공개되는 ID 변경은 주당 약 1~2회, 1% 미만이라고 가정할 수 있습니다.
-
Grab: 다음과 같은 상황에서는 장소 ID가 만료되거나 유효하지 않게 될 수 있습니다.
데이터 작업: Grab Map Ops는 현실 세계에서 폐쇄되었거나, 중복된 POI로 감지되거나, 정보가 올바르지 않은 경우 등 근거 정보를 기반으로 Grab POI 데이터베이스에서 POI를 제거할 수 있습니다. Grab은 매주 데이터를 Waypoint 환경과 동기화합니다.
보간 POI: 보간 POI는 요청을 처리할 때 실시간으로 생성되는 임시 POI이며, 응답 시 필드에서 파생된 것으로 표시됩니다.
place.result_type
보간된 POI의 정보는 최소 30일 동안 보관됩니다. 즉, 30일 이내에 장소 세부정보 API에서 장소 ID로 POI 세부정보를 얻을 수 있습니다. 30일이 지나면 보간된 POI (장소 ID 및 세부정보 모두) 가 만료되어 장소 세부정보 API에서 액세스할 수 없게 될 수 있습니다.