장소 찾기 (기존)

장소 찾기 (기존) 요청은 텍스트 입력을 받아 장소를 반환합니다. 입력은 이름, 주소, 전화번호와 같은 모든 유형의 장소 텍스트 데이터일 수 있습니다. 요청은 문자열이어야 합니다. 위도/경도 좌표 또는 Plus Code와 같은 문자열이 아닌 데이터를 사용하는 장소 찾기 (기존) 요청은 오류를 생성합니다.

장소 찾기 (기존) 요청

장소 찾기 (기존) 요청은 다음과 같은 형식의 HTTP URL입니다.

https://maps.googleapis.com/maps/api/place/findplacefromtext/output?parameters

여기서 output는 다음 값 중 하나일 수 있습니다.

• json (권장)은 JavaScript 객체 표기법 (JSON)의 출력을 나타냅니다.
• xml: 출력을 XML로 표시

장소 찾기 (기존) 요청을 시작하려면 특정 매개변수가 필요합니다. URL에서와 마찬가지로 모든 매개변수는 앰퍼샌드(&) 문자를 사용하여 구분합니다.

필수 매개변수

• 입력

  검색할 텍스트 문자열입니다. 장소 이름, 주소 또는 전화번호여야 합니다(예: '중앙로 123' 또는 '시청').

• inputtype

  입력 유형입니다. textquery 또는 phonenumber 중 하나일 수 있습니다. 전화번호는 국가 코드 포함 형식(앞에 더하기 기호 ('+')가 있고 그 뒤에 국가 코드, 전화번호가 나오는 형식)이어야 합니다. 자세한 내용은 E.164 ITU 권장사항을 참고하세요.

선택적 매개변수

• 필드

  주의: 장소 검색 (기존) 요청과 장소 세부정보 (기존) 요청은 동일한 필드를 반환하지 않습니다. 장소 검색 (기존) 요청은 장소 세부정보 (기존) 요청에서 반환하는 필드의 하위 집합을 반환합니다. 장소 검색 (기존)에서 원하는 필드를 반환하지 않는 경우 장소 검색 (기존)을 사용하여 place_id를 가져온 다음 이 장소 ID를 사용하여 장소 세부정보 (기존)를 요청할 수 있습니다. 장소 검색 (기존) 요청에서 사용할 수 없는 필드에 대한 자세한 내용은 Places API 필드 지원을 참고하세요.

  fields 매개변수를 사용하여 반환할 장소 데이터 유형의 쉼표로 구분된 목록을 지정합니다. 예를 들면 fields=formatted_address,name,geometry입니다. 복합 값을 지정하려면 슬래시를 사용하세요. 예를 들면 opening_hours/open_now입니다.

  필드는 Basic, 연락처, 분위기 등 세 결제 카테고리로 분류됩니다. 기본 필드에는 기본 요율로 청구되며 연락처 및 분위기 필드에는 더 높은 요율로 청구됩니다. Basic, Contact, Atmosphere SKU는 이를 트리거한 요청의 기본 SKU (장소 세부정보, 장소 검색, 주변 지역 검색, 텍스트 검색) 외에 추가로 청구됩니다. 자세한 내용은 가격표를 참고하세요.

  기본

  기본 카테고리에는 다음 필드가 포함됩니다. address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (지원 중단됨), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

  연락처

  연락처 카테고리에는 다음 필드가 포함됩니다. current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

  분위기

  분위기 카테고리에는 다음 필드가 포함됩니다. curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

  참고: 저작자 표시(html_attributions)는 필드 요청 여부에 관계없이 모든 호출에서 항상 반환됩니다.

• language

  결과를 반환할 언어입니다.

  • 지원 언어 목록을 참고하세요. Google에서는 지원되는 언어를 자주 업데이트하므로 이 목록에 모든 언어가 포함되지 않을 수도 있습니다.
  • language가 제공되지 않으면 API는 Accept-Language 헤더에 지정된 기본 언어를 사용하려고 시도합니다.
  • API는 사용자와 현지인 모두가 읽을 수 있는 상세 주소를 제공하기 위해 최선을 다합니다. 이 목표를 달성하기 위해 선호하는 언어를 준수하면서 필요한 경우 사용자가 읽을 수 있는 스크립트로 음역된 현지 언어로 상세 주소를 반환합니다. 다른 모든 주소는 기본 언어로 반환됩니다. 주소 구성요소는 모두 첫 번째 구성요소에서 선택한 언어로 반환됩니다.
  • 선호하는 언어로 된 이름이 없는 경우 API는 가장 일치하는 이름을 사용합니다.
  • 기본 언어는 API가 반환하도록 선택하는 결과 집합과 반환되는 순서에 약간의 영향을 미칩니다. 지오코더는 언어에 따라 약어를 다르게 해석합니다. 예를 들어 도로 유형의 약어나 동의어는 한 언어에서는 유효하지만 다른 언어에서는 유효하지 않을 수 있습니다. 예를 들어 utca 및 tér은 헝가리어로 street의 동의어입니다.

• locationbias

  반경과 위도/경도 또는 직사각형의 지점을 나타내는 두 개의 위도/경도 쌍을 지정하여 지정된 지역의 결과를 선호합니다. 이 매개변수를 지정하지 않으면 API는 기본적으로 IP 주소 편향을 사용합니다.

  • IP 편향: API에 IP 주소 편향을 사용하도록 지시합니다. 문자열 ipbias를 전달합니다 (이 옵션에는 추가 매개변수가 없음).
  • 원형: 반경(미터)과 위도/경도(십진수)를 지정하는 문자열입니다. circle:radius@lat,lng 형식을 사용하세요.
  • 직사각형: 직사각형의 남/서 및 북/동 지점을 나타내는 두 개의 위도/경도 쌍을 십진수로 지정하는 문자열입니다. rectangle:south,west|north,east 형식을 사용합니다. 동/서 값은 -180, 180 범위로 래핑되고 북/남 값은 -90, 90 범위로 고정됩니다.

장소 찾기 (기존) 예시

다음 예는 'Museum of Contemporary Art Australia'에 대한 장소 찾기 (기존) 요청을 보여줍니다. 여기에는 photos, formatted_address, name, rating, opening_hours, geometry 필드가 포함됩니다.

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

다음 예는 'Mongolian Grill'에 대한 장소 찾기 (기존) 요청을 보여줍니다. locationbias 매개변수를 사용하여 지정된 좌표에서 2,000미터 이내의 결과를 선호합니다.

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

다음 예는 전화번호에 대한 장소 검색 (기존) 요청을 보여줍니다. 이 요청이 규정을 준수하는 URL이 되도록 국제 전화 접두사 '+'가 %2B로 인코딩되었습니다. 인코딩되지 않은 상태로 두면 + 접두사가 서버에서 공백으로 디코딩되어 잘못된 전화번호 조회가 발생합니다.

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

장소 찾기 (기존) 응답

장소 찾기 (기존) 응답에는 fields 매개변수를 사용하여 지정된 데이터 유형과 html_attributions만 포함됩니다. 다음 예는 'Museum of Modern Art Australia'에 대한 장소 찾기 (기존) 요청에 대한 응답을 보여줍니다. 여기에는 formatted_address, geometry, name, opening_hours, photos, rating 필드가 포함됩니다.

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}    

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

    

PlacesFindPlaceFromTextResponse

PlacesSearchStatus

서비스에서 반환하는 상태 코드입니다.

• OK - API 요청이 성공적이었음을 나타냅니다.
• ZERO_RESULTS: 검색이 성공했지만 반환된 결과가 없음을 나타냅니다. 검색이 원격 위치의 latlng에 전달된 경우 이러한 결과가 발생할 수도 있습니다.
• INVALID_REQUEST - API 요청의 형식이 잘못되었음을 나타냅니다. 일반적으로 필수 쿼리 매개변수 (location 또는 radius)가 누락되었기 때문입니다.
• OVER_QUERY_LIMIT: 다음 중 하나를 나타냅니다.
  • QPS 한도를 초과했습니다.
  • 계정에 결제가 사용 설정되지 않았습니다.
  • 월 200달러의 크레딧 또는 자체 적용되는 사용량 한도를 초과했습니다.
  • 제공된 결제 수단이 더 이상 유효하지 않습니다 (예: 신용카드가 만료됨).
  이 오류를 해결하는 방법에 대한 자세한 내용은 지도 FAQ를 참고하세요.
• REQUEST_DENIED - 요청이 거부되었음을 나타내며, 일반적으로 다음과 같은 이유 때문입니다.
  • 요청에 API 키가 없습니다.
  • key 매개변수가 잘못되었습니다.
• UNKNOWN_ERROR - 알 수 없는 오류를 나타냅니다.

장소

장소 검색 응답은 장소 필드의 다음 하위 집합을 반환합니다. 일부 장소 유형에서는 일부 속성을 사용할 수 없습니다. 장소 검색에서 반환하지 않는 필드(예: address_components, formatted_phone_number, reviews, website)를 가져오려면 반환된 place_id를 장소 세부정보(기존) 요청에 전달합니다. 엔드포인트 전반의 필드 가용성 및 가격 책정 등급은 장소 데이터 필드 (기존)를 참고하세요.