Google 지도 링크

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

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

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

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'

대답에 길 안내 포함

모든 Places 메서드는 응답에서 경로 링크 생성을 지원합니다. 현재 위치가 출발지로 사용되고, 장소 위치가 목적지로 사용되며, 이동 모드는 자동차입니다.

다음 예에서는 Nearby Search (New)를 사용하여 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 옵션을 익힐 수 있습니다.

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

  2. 선택적으로 표준 매개변수 표시를 펼치고 fields 매개변수를 필드 마스크로 설정합니다.

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

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

  5. API 탐색기 패널에서 를 선택합니다.

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