Google 지도 링크

Places API (신규)는 다양한 방법을 통해 장소 데이터 요청을 수락합니다. Places API (신규) 응답에는 위치 데이터 및 이미지, 지리적 위치, 주요 관심 지점 등 장소에 관한 데이터가 포함됩니다.

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

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

Place 객체에 추가된 링크와 함께 googleMapsUri 필드도 응답의 Reviews 및 Photos 객체에 추가됩니다.

  • Reviews.googleMapsUri: 리뷰로 연결되는 Google 지도 링크가 포함되어 있어 브라우저에서 리뷰를 볼 수 있습니다.

  • Photos.googleMapsUri: 사진으로 연결되는 Google 지도 링크가 포함되어 있어 브라우저에서 사진을 볼 수 있습니다.

API 탐색기를 사용하면 이러한 새로운 옵션을 숙지할 수 있도록 실시간 요청을 보낼 수 있습니다.

사용해 보기

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

Google 지도 링크 설명 필드 이름
장소 장소로 연결되는 Google 지도 링크입니다. googleMapsLinks.placeUri
경로 Google 지도에서 장소로 연결되는 경로를 여는 링크입니다. googleMapsLinks.directionsUri
리뷰 작성 Google 지도에서 장소에 관한 리뷰를 작성하는 링크입니다. googleMapsLinks.writeAReviewUri
리뷰 읽기 장소에 관한 Google 지도 리뷰를 표시하는 링크입니다. googleMapsLinks.reviewsUri
사진 Google 지도에서 장소의 사진을 표시하는 링크입니다. googleMapsLinks.photosUri

장소 응답의 링크는 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'

응답에 경로 포함

모든 장소 메서드는 응답에서 경로 링크 생성을 지원합니다. 현재 위치는 출발지로 사용되고 장소 위치는 도착지로 사용되며 이동 수단은 운전입니다.

다음 예에서는 주변 검색 (신규)을 사용하여 응답의 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

이 출시 버전에서는 응답의 googleMapsUri 필드가 Reviews 및 Photos 객체에 추가됩니다. 이러한 링크를 탐색하면 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 옵션을 숙지할 수 있도록 샘플 요청을 보낼 수 있습니다.

  1. 페이지 오른쪽의 API 아이콘을 선택합니다.

  2. 원하는 경우 표준 매개변수 표시 를 펼치고 fields 매개변수 를 필드 마스크로 설정합니다.

  3. 원하는 경우 요청 본문 을 수정합니다.

  4. 실행 버튼을 선택합니다. 대화상자에서 요청을 보내는 데 사용할 계정을 선택합니다.

  5. API 탐색기 패널에서

    전체 화면 을 선택하여 API 탐색기 창을 펼칩니다.