이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Google 지도 링크

Places API는 다양한 메서드를 통해 장소 데이터에 대한 요청을 수락합니다. Places API 응답에는 위치 데이터 및 이미지, 지리적 위치, 주요 관심 장소 등 장소에 관한 데이터가 포함됩니다.

이번 출시에서는 텍스트 검색, 주변 검색, 장소 세부정보의 응답에 Google 지도 링크도 포함될 수 있습니다. 사용자는 이러한 Google 지도 링크를 탐색하여 대답에서 장소에 관한 추가 정보를 확인할 수 있습니다.

예를 들어 캘리포니아 샌프란시스코의 공항을 검색합니다. 그러면 응답의 장소 목록에 샌프란시스코 국제공항 (SFO)이 포함됩니다. 이번 출시에서는 응답의 SFO에 관한 Place 객체에 Google 지도에서 장소를 여는 Google 지도 링크, 장소로 가는 경로, 장소 리뷰, 장소 사진이 포함된 googleMapsUri 필드가 추가됩니다.

이 버전에서는 Place 객체에 추가된 링크와 함께 응답의 Reviews 및 Photos 객체에 googleMapsUri 필드도 추가합니다.

Reviews.googleMapsUri: 브라우저에서 리뷰를 볼 수 있도록 리뷰에 대한 Google 지도 링크가 포함되어 있습니다.
Photos.googleMapsUri: 브라우저에서 사진을 볼 수 있도록 사진의 Google 지도 링크가 포함되어 있습니다.

API 탐색기를 사용하면 실시간으로 요청하여 다음과 같은 새로운 옵션을 익힐 수 있습니다.

사용해 보기

장소에 지원되는 Google 지도 링크

다음 표에는 응답에 포함할 수 있는 Google 지도 링크가 나와 있습니다.

Google 지도 링크	설명	필드 이름
장소	장소로 Google 지도를 여는 링크입니다.	`googleMapsLinks.placeUri`
경로	Google 지도에서 장소까지의 경로를 여는 링크입니다.	`googleMapsLinks.directionsUri`
리뷰 작성	Google 지도에서 장소에 대한 리뷰를 작성할 수 있는 링크입니다.	`googleMapsLinks.writeAReviewUri`
리뷰 읽기	장소에 대한 Google 지도 리뷰를 보여주는 링크입니다.	`googleMapsLinks.reviewsUri`
사진	Google 지도에서 장소의 사진을 표시하는 링크입니다.	`googleMapsLinks.photosUri`

가격 책정

이 기능은 GA 이전 미리보기 단계에 있으며 미리보기 기간 동안 사용 시 요금이 청구되지 않으므로 청구 금액은 0달러입니다. 제안된 가격에 관한 자세한 내용은 Places API 사용량 및 결제를 참고하세요.

장소 응답에 모든 링크 포함

장소 응답의 링크는 googleMapsLinks 필드에 포함되어 있습니다. googleMapsLinks 필드가 응답에 표시되도록 하려면 요청의 필드 마스크에 googleMapsLinks 필드를 포함해야 합니다.

예를 들어 다음 텍스트 검색에는 응답에 모든 지도 링크가 포함됩니다.

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'

응답 형식은 다음과 같습니다.

{
  "places": [
    {
      "formattedAddress": "San Francisco, CA 94128, USA",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "googleMapsLinks": {
        "placeUri": "https://maps.google.com/?cid=11885663895765773631",
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
      }
    }
  ]
}

응답에 특정 링크 포함

응답에서 모든 링크를 반환할 필요는 없습니다. 예를 들어 응답에 사진 링크만 포함하려면 아래와 같이 필드 마스크를 수정하여 photosUri 필드만 포함합니다.

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'

응답에 경로 포함

모든 Places 메서드는 응답에서 경로 링크 생성을 지원합니다. 현재 위치가 출발지로, 장소 위치가 목적지로, 이동 수단이 운전으로 사용됩니다.

다음 예에서는 Nearby Search를 사용하여 directionsUri 필드의 응답에 지도 경로 링크를 포함합니다.

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": -33.8688,
        "longitude": 151.1957362},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby

리뷰 및 사진 링크 포함

이 출시에서는 응답의 Reviews 및 Photos 객체에 googleMapsUri 필드를 추가합니다. 이러한 링크를 탐색하면 Google 지도에서 리뷰 또는 사진이 열립니다.

예를 들어 다음 텍스트 검색에는 응답에 각 장소의 리뷰와 사진이 포함됩니다.

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.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'

응답에서 리뷰 및 사진 배열의 각 요소에는 브라우저에서 리뷰 또는 사진을 열 수 있는 googleMapsUri 필드가 포함되어 있습니다.

사용해 보기

API 탐색기를 사용하면 샘플 요청을 실행하여 API 및 API 옵션을 익힐 수 있습니다.

페이지 오른쪽에 있는 API 아이콘 을 선택합니다.
원하는 경우 표준 매개변수 표시를 펼치고 fields 매개변수를 필드 마스크로 설정합니다.
원하는 경우 요청 본문을 수정합니다.
실행 버튼을 선택합니다. 대화상자에서 요청하는 데 사용할 계정을 선택합니다.
API 탐색기 패널에서 펼치기 아이콘 을 선택하여 API 탐색기 창을 펼칩니다.