지도 URL 빠른 참조

지도 URL을 사용하면 범용 크로스 플랫폼 URL을 구성하여 Google 지도를 실행하고 검색하고 경로를 찾고 내비게이션을 실행하고 지도뷰를 표시하고 장소 관심 목록을 만들고 스트리트 뷰 파노라마를 표시할 수 있습니다. URL 문법은 모든 플랫폼에서 동일하며 API 키가 필요하지 않습니다.

지도 URL: 주요 사실

  • 제품: 지도 URL
  • 다른 이름: Google 지도 URL
  • 카테고리: 지도
  • 플랫폼: URL 스키마
  • 출시 단계: GA
  • 수명 주기: 활성
  • 개요: 지도 URL 개요

지도 URL: 사용 시기

다음과 같은 경우에 지도 URL을 사용하세요.

  • Android 앱, iOS 앱 또는 웹사이트에서 Google 지도를 열어 장소를 검색하거나 검색 결과를 표시하는 링크가 필요합니다.
  • 지점 간 경로가 표시된 Google 지도를 열어야 합니다. 경유지, 이동 수단 또는 세부 경로 안내 내비게이션을 선택할 수 있습니다.
  • API 키를 사용하지 않고 지도 뷰, 장소 목록 또는 스트리트 뷰 파노라마로 Google 지도를 열어야 합니다.
  • Android, iOS, 데스크톱 브라우저에서 동일하게 작동하는 URL 문법이 필요합니다.

다음과 같은 경우에는 지도 URL을 사용하지 마세요.

  • 이미 장소 세부정보를 요청하고 있으며 장소에 대해 미리 형식이 지정된 Google 지도 링크(googleMapsUri 또는 googleMapsLinks 필드)를 원하는 경우 대신 Places API(신규)를 사용하세요.
  • Google 지도 앱을 실행할 때 모바일 전용 기능이 필요합니다. Android용 Google 지도 인텐트 또는 iOS용 Google 지도 URL 스키마를 사용하세요.

지도 URL: 설정

  • 사용 기여 분석: 선택사항인 utm_source(애플리케이션 이름) 및 utm_campaign(사용자의 의도된 작업, 예: place_details_search) 쿼리 매개변수를 지도 URL에 추가합니다.
  • 시작하기: 지도 URL 설정하기

지도 URL: 일반적인 실수

  • 문제: query에 위도/경도만 있는 검색 URL은 핀을 표시하지만 지도나 측면 패널에 장소 세부정보를 표시하지 않습니다. 해결 방법: query=PLACE_NAME,ADDRESS를 사용하거나 query와 함께 query_place_id를 추가하여 특정 장소의 세부정보를 표시합니다. /maps/documentation/urls/get-started를 참고하세요.
  • 문제: 장소 ID 매개변수(query_place_id, origin_place_id, destination_place_id, waypoint_place_ids)는 단독으로 작동하지 않습니다. 해결 방법: 장소 ID 매개변수를 전달할 때는 항상 일치하는 기본 매개변수(query, origin, destination 또는 waypoints)를 포함하세요. /maps/documentation/urls/get-started를 참고하세요.
  • 문제: waypoints 매개변수는 경유지를 지원하지 않고 플랫폼에 따라 개수 제한이 있는 Google 지도 제품에서 무시되며, dir_action=navigate는 내비게이션을 사용할 수 없는 경우 무시됩니다. 해결 방법: 모바일 브라우저에서 열리는 링크에는 경유지를 3개 이하로 사용하고(그 외의 경우 9개), 모든 Google 지도 제품 또는 경로에서 waypoints 또는 dir_action=navigate가 작동한다고 가정하지 마세요. /maps/documentation/urls/get-started#directions-action을 참고하세요.
  • 문제: 지도와 스트리트 뷰는 동일한 @ 엔드포인트를 공유하므로 올바른 작업이 없는 지도 URL은 지도를 표시하지 않을 수 있습니다. 해결 방법: 지도 뷰에는 map_action=map를, 스트리트 뷰 파노라마에는 map_action=pano를 설정합니다. /maps/documentation/urls/get-started를 참고하세요.
  • 문제: 지도 URL에 api=1가 누락된 경우 모든 매개변수가 무시되고 Google 지도가 기본 뷰를 엽니다. 해결 방법: 모든 지도 URL에 api=1를 포함합니다(1만 유효한 값임). /maps/documentation/urls/get-started#forming-the-url을 참고하세요.