[GIS] Google Map 장소 ID란? (Places API)

Google Maps Platform의 Places API 관련 장소 ID의 개념과 활용 방법

---

1. 장소 ID란?

• 장소 ID는 Google 지도 데이터베이스 및 Google 지도에서 장소를 고유하게 식별하는 텍스트 형식의 식별자입니다.
• 길이는 고정되어 있지 않으며, 최대 길이 제한도 없습니다.
  • 예시:
    • ChIJgUbEo8cfqokR5lP9_Wh_DaM
    • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E
• 사용 가능 장소:
  • 비즈니스, 명소, 공원, 교차로 등 대부분의 장소를 포함.
  • 동일한 장소에 대해 여러 장소 ID가 존재할 수 있음.
  • 장소 ID는 시간이 지남에 따라 변경될 수 있으며, 장소의 상태 변화(이전, 폐업 등)에 따라 새로운 ID가 부여되기도 함.

---

2. 장소 ID의 주요 활용 사례

장소 ID는 여러 Google Maps API에서 다음과 같이 활용될 수 있습니다:

1. 경로 계산
   • Routes API, Directions API: 출발지, 목적지, 경유지 지정.
2. 거리 계산
   • Distance Matrix API: 출발지와 목적지 간 거리 계산.
3. 장소 정보 조회
   • Places API를 통해 장소 세부정보 검색 및 가져오기.
   • 예: 특정 비즈니스의 주소, 이름, 연락처 정보.
4. 지도 임베드
   • Maps Embed API: 특정 장소를 지도에 표시할 때 장소 ID를 매개변수로 사용.
5. 경계 다각형 스타일 지정
   • 장소 ID를 기반으로 경계 데이터를 검색해 지도에 스타일 적용.
6. 특정 장소 검색
   • Places API를 사용하여 텍스트 기반으로 장소 검색.

---

3. 장소 ID 저장 및 갱신

• 저장 가능 여부:
  • 장소 ID는 Google Maps Platform의 서비스 약관(3.2.3(b)항)에 따라 캐싱 제한이 없어 저장 가능.
  • 장소 ID를 저장해두면 나중에 동일한 장소를 다시 참조할 수 있음.
• 갱신 필요성:
  • 장소 ID는 시간이 지남에 따라 유효성을 잃을 수 있음.
  • 12개월 이상 지난 장소 ID는 갱신하는 것이 권장됨.
  • 갱신 방법:
    • Place Details 요청에서 fields 매개변수에 장소 ID만 포함하여 갱신 요청 실행.
    • 갱신 시 무료로 처리되며, 만약 장소가 폐기되었다면 NOT_FOUND 상태 반환.

---

4. 장소 ID 검색 및 활용 예시

• 검색 요청:
  • Places API의 텍스트 검색 기능을 사용하여 장소 ID를 검색 가능.
  • 예시:

    curl -X POST -d '{
      "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
    }' \
    -H 'Content-Type: application/json' \
    -H 'X-Goog-Api-Key: API_KEY' \
    -H 'X-Goog-FieldMask: places.id,places.displayName,places.formattedAddress' \
    'https://places.googleapis.com/v1/places:searchText'

  • 응답 예시:

    {
      "places": [
        {
          "id": "ChIJs5ydyTiuEmsR0fRSlU0C7k0",
          "formattedAddress": "29 King St, Sydney NSW 2000, Australia",
          "displayName": {
            "text": "Peace Harmony",
            "languageCode": "en"
          }
        }
      ]
    }

• 장소 ID를 활용한 상세 정보 요청:
  • 장소 ID를 활용해 추가적인 세부 정보를 요청 가능.
  • 예시:

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

---

5. 장소 ID 사용 시 발생할 수 있는 오류

1. INVALID_REQUEST
   • 요청된 장소 ID가 잘못되었거나 유효하지 않을 경우 반환.
   • 장소 ID가 잘리거나 수정된 경우에도 발생 가능.
2. NOT_FOUND
   • 지정된 장소 ID가 더 이상 유효하지 않음을 의미.
   • 발생 이유:
     • 비즈니스 폐업.
     • 장소가 새로운 위치로 이전.
     • Google 지도 데이터베이스 업데이트로 ID가 변경.
3. 특정 장소 유형에서 발생 가능성:
   • 다음과 같은 장소 유형의 ID는 NOT_FOUND가 발생하거나 새로운 ID가 반환될 가능성이 있음:
     • Google 지도에 존재하지 않는 주소를 기반으로 생성된 장소.
     • 긴 경로 상의 특정 지점.
     • 교차로나 subpremise 유형의 장소.

---

6. 주의 사항 및 추가 정보

• 장소 ID는 장소를 고유하게 나타내지만, 동일한 장소에 대해 다른 ID가 존재할 수 있음.
• 원래 장소 ID 요청 데이터를 저장하면, 장소 ID가 무효화된 경우에도 최신 정보를 갱신하는 데 도움이 됨.
• 저장된 요청 데이터는 재실행 시 요금이 청구될 수 있음.

 

 

 

https://developers.google.com/maps/documentation/places/web-service/place-id?hl=ko&_gl=1*1qtv7qp*_up*MQ..*_ga*MTAwMDE2NzUyOC4xNzM3Mjg2NDI0*_ga_NRWSTWS78N*MTczNzI4NjQyNC4xLjEuMTczNzI4NjY3NS4wLjAuMA..

장소 ID  |  Places API  |  Google for Developers