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

자동차로 이동할 때 최적의 사용자 환경을 만들기 위한 도움말

이 문서는 이전 버전의 GMP API를 사용한 이전 도움말을 업데이트한 것입니다. 이 콘텐츠는 2023~2024년에 출시된 새로운 버전의 Places API와 2023년에 출시된 Routes API로 업데이트되었습니다.

일반적으로 사용자가 관심 장소 (POI)로 운전하는 경우 주차장이나 진입로와 같은 인근 위치로의 탐색이 실제로 필요합니다. 공항이나 쇼핑몰로 가야 하는 운전자를 생각해 보세요. 공항으로 이동할 때 운전자는 공항 구역의 중심이 아닌 터미널이나 하차 지점에 도달하려고 합니다. 마찬가지로 쇼핑센터 옆에 있는 주차장은 자동차를 소유한 사용자에게 훨씬 더 나은 옵션일 수 있습니다. 이 경우 운전자를 안내하는 앱이나 서비스를 개발할 때는 먼저 운전자가 가려는 위치를 찾은 다음 해당 위치 근처의 선택적 목적지를 운전자에게 제공합니다. 이 접근 방식을 사용하면 Google Maps Platform에서 제공하는 위치 데이터를 활용하는 작지만 스마트한 개발 노력으로 고객에게 더 나은 서비스를 제공하고 고객의 시간을 소중히 여긴다는 점을 보여줄 수 있습니다.

시스템 다이어그램

새 Places API와 Routes API를 순서대로 또는 조합하여 목적지 옆에 주차할 적절한 위치를 식별하는 방법을 보여드리겠습니다. 이 솔루션은 최종 목적지에 가까워졌을 때 운전 중에 주차할 곳을 찾기 위한 불확실성과 여러 상호작용을 없애는 것을 목표로 합니다. 이러한 사례가 자세히 구현되는 두 가지 예를 살펴보세요.

예 1 - 주차장이 없는 관광 명소

경로를 별도로 검색해야 하도록 도로변과 직접 연결되지 않는 위치를 선택합니다. 목적지는 파리의 노트르담이고 시작점은 파리 동역 기차역(48.87697775149635, 2.3592247806755564)을 사용합니다.

Gare l'Est

운전자는 노트르담에서 북쪽으로 약 16분 거리에 있는 역을 출발합니다. 노트르담은 다리로 연결된 섬에 있는 유명한 관광 명소로, 일방통행로가 있고 근처에 대형 주차장이 없으므로 흥미로운 도전이 될 것입니다.

1. Places API 요청

이 예시 Places API 요청은 텍스트 검색을 사용하여 노트르담을 찾습니다. 자세한 내용은 개발자 문서를 참고하세요. 이 예의 '$APIKEY'는 Google Cloud 콘솔에서 사용 설정된 Google Maps Platform Places 및 Routes API의 API 키입니다. 자세한 설명은 Google Maps Platform 시작하기 문서를 참고하세요.

새로운 Places API 요청의 형식이 변경되었습니다. 응답 필드가 더 이상 고정되지 않으므로 개발자는 헤더에 fieldmask를 정의해야 합니다. fieldmask 사용은 문서에 정의되어 있습니다.

curl -X POST --data @notre_dame.json \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: $APIKEY" \
-H 'X-Goog-FieldMask: places.id,places.displayName,places.formattedAddress,places.location' \
'https://places.googleapis.com/v1/places:searchText'

검색 매개변수에 'notre_date.json' 콘텐츠 사용:

{
   "textQuery": "Notre Dame, Paris",
   "languageCode": "en"
}

위 요청에 대한 응답은 다음 위도 및 경도 좌표를 제공합니다.

{
  "places": [
    {
      "id": "ChIJATr1n-Fx5kcRjQb6q6cdQDY",
      "formattedAddress": "6 Parvis Notre-Dame - Pl. Jean-Paul II, 75004 Paris, France",
      "location": {
        "latitude": 48.852968200000007,
        "longitude": 2.3499021
      },
      "displayName": {
        "text": "Cathédrale Notre-Dame de Paris",
        "languageCode": "en"
      }
    }
  ]
}

보시다시피 좌표가 노트르담을 정확하게 가리킵니다.

개발자 또는 서비스 제공업체는 운전자에게 '노트르담 근처에 주차할 곳을 찾으시나요?'라고 자동으로 묻거나 운전자가 전기 자동차를 보유한 경우 충전소를 검색하는 것이 좋습니다. 사용자 환경은 기기와 화면에 따라 다르지만, 이 경우 짧은 시간 후에 사라지는 미묘한 대화상자 텍스트를 고려해 볼 수 있습니다. 노트르담 근처 주차장을 찾으려면 반경이 500미터이고 유형이 'parking' 및 'electric_vehicle_charging_station'인 Places API 주변 검색을 실행합니다. 다음 예에서는 노트르담에서 500미터 이내의 주차 공간으로 결과가 편향됩니다.

curl -X POST -d '{
  "includedTypes": ["parking", "electric_vehicle_charging_station"],
  "maxResultCount": 10,
  "rankPreference": "DISTANCE",
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 48.852968200000007,
        "longitude": 2.3499021},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: $APIKEY" \
-H "X-Goog-FieldMask: places.displayName,places.location" \
https://places.googleapis.com/v1/places:searchNearby

첫 번째 결과는 48.854981, 2.350629에 있는 충전소입니다. 하지만 이 예시를 실행할 때 결과가 다를 수 있습니다. 다음 파트에서 Routes API 요청을 실행할 때 이 위치를 사용합니다.

2. Routes API 요청

역에서 노트르담 근처의 충전소까지의 경로를 찾으려면 Routes API 요청을 해야 합니다. 출발지와 목적지 매개변수만 설정하면 됩니다. 다른 옵션은 개발자 문서를 참고하세요.

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 48.87697775149635,
        "longitude": 2.3592247806755564
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
       "latitude": 48.854981,
        "longitude": 2.350629
      }
    }
  },
  "travelMode": "DRIVE",
  "routingPreference": "TRAFFIC_AWARE",
  "departureTime": "2024-05-16T15:01:23.045123456Z",
  "computeAlternativeRoutes": false,
  "routeModifiers": {
    "avoidTolls": false,
    "avoidHighways": false,
    "avoidFerries": false
  },
  "languageCode": "en-US",
  "units": "METRIC"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: $APIKEY" \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs,routes.polyline.encodedPolyline' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Routes API 응답에는 일반적으로 여러 경로 추천이 포함됩니다. 응답에 경로 데이터를 포함하려면 fieldmask에서 'routes.legs'를 정의하세요. 각 경로에는 여러 '구간'이 포함되며, 구간에는 이동 거리와 좌표를 보여주는 여러 '단계'가 포함됩니다. 자동차로 도달할 수 있는 최종 좌표를 찾으려면 선택한 경로의 마지막 구간의 마지막 단계에 있는 'endLocation' 필드를 사용하세요. "latitude": 48.854937299999996, "longitude": 2.3505841999999997

이 위치가 첫 번째 선택이 아닌 것처럼 보일 수 있지만 지도나 Google 스트리트 뷰를 보면 노트르담에서 도보로 매우 가까운 거리(약 6~7분)에 있음을 알 수 있습니다.

노트르담 성당까지 가는 길

충전소 주차장에서 노트르담까지의 도보 경로

예 1 요약

보시다시피 자동차 주차 공간을 찾는 데는 몇 번의 API 호출과 운전자에게 제안을 표시하는 것만 필요합니다. 사용자가 일방통행로를 운전하거나 혼잡한 관광 명소에서 차를 세울 곳을 찾지 않아도 되므로 시간을 절약할 수 있습니다. 요약하자면 다음과 같은 API 요청을 했습니다.

노트르담 좌표를 찾는 Places API 텍스트 검색 요청
해당 좌표에서 500m 이내에 전기 자동차 충전소가 있는 주차장을 찾는 Places API 주변 검색
충전소로 가는 경로를 찾는 Routes API 요청

예 2 - 대형 공항의 터미널 안내

히스로 공항 지도

운전자가 여러 위치, 관심 장소 또는 잠재적 하차 지점이 있는 넓은 지역에 도달하려고 하는 다른 예를 생각해 보세요. 운전자가 영국 웸블리 스타디움 (51.557263604707224, -0.2794575145680608)에서 출발하여 런던 히스로 공항 터미널 5로 이동하려고 합니다.

새 Places API 자동 완성의 장점은 API가 하위 구역을 잠재적인 검색 결과로 예측하는 것과 함께 기본 유형을 검색 기준으로 정의할 수 있다는 점입니다. 이 경우 공항과 주차장을 검색하면 터미널이나 주차장도 반환됩니다. 포함하거나 제외할 유형의 전체 목록은 문서에서 확인할 수 있습니다.

curl -X POST -d '{
  "input": "Heathrow",
  "includedPrimaryTypes": ["airport", "parking"]
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: $APIKEY" \
https://places.googleapis.com/v1/places:autocomplete

위의 쿼리는 터미널과 해당 터미널의 개별 하차 지점 목록을 제공합니다. 결과 목록에서 'London Heathrow Airport Terminal 5'와 장소 ID를 찾을 수 있습니다.

"place_id" : "ChIJo21hnPxxdkgRksRL0KQRWII",

'placeId' 매개변수를 사용하면 임의의 좌표가 아닌 장소에 도달하려고 함을 Routes API에 알릴 수 있습니다.

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 51.557263604707224,
        "longitude": -0.2794575145680608
      }
    }
  },
  "destination":{
    "placeId": "ChIJo21hnPxxdkgRksRL0KQRWII"
  },
  "travelMode": "DRIVE",
  "routingPreference": "TRAFFIC_AWARE",
  "departureTime": "2024-05-16T15:01:23.045123456Z",
  "computeAlternativeRoutes": false,
  "languageCode": "en-US",
  "units": "METRIC"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: $APIKEY" \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs,routes.polyline.encodedPolyline' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

이전 예와 마찬가지로 JSON 응답의 모든 단계를 읽으면 여정의 마지막 부분과 종료 위치의 위도 및 경도 좌표 (51.4714348, 'longitude': -0.48967890000000003)를 확인할 수 있습니다.

터미널 5 스트리트 뷰

예 2 요약

이전 예와 마찬가지로 드라이버에 개선된 안내를 제공하기 위한 개발 노력은 매우 적으며 드라이버가 절약하는 시간의 이점을 측정할 수 있습니다. 다음 요청을 수행했습니다.

히스로 공항 터미널 5를 찾는 Places API 자동 완성 (신규) 요청
웸블리에서 터미널 5까지의 경로를 가져오는 Routes API 요청

이 예시는 새로운 Places API 기능의 일부에 불과합니다. 활주로, 국제공항과 같은 새로운 장소 유형을 확인해 보세요.

결론

보시다시피 자동차로 이동하는 고객에게 프리미엄 서비스를 제공하는 데 필요한 개발 노력은 매우 적으며 고객의 요구사항을 어떻게 생각하는지 보여줄 수 있습니다.

개발 목적으로 고객을 위한 서비스를 빌드하는 데 사용할 수 있는 다양한 라이브러리와 도구를 사용할 수 있습니다. 공개적으로 제공되는 Google Maps Platform GitHub 저장소를 살펴보세요.

다음 작업

GMP 시작하기 : https://developers.google.com/maps/get-started

참여자

주요 저자: 미코 토이바넨 | Google Maps Platform 솔루션 엔지니어

자동차로 이동할 때 최적의 사용자 환경을 만들기 위한 도움말 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.