如何将Salesforce与Google地图集成?

时间:2010-06-25 23:19:02

标签: google-maps salesforce

如何将Salesforce与Google地图集成?我只是在寻找有关如何...的信息。

  1. 在Salesforce中搜索联系人
  2. 在谷歌地图上绘制那些。

3 个答案:

答案 0 :(得分:11)

修改

感谢tggagne的评论,我意识到人们仍然会看到这个答案。这里的代码已超过2.5年。如果您想看到它 - 请查看编辑的历史记录。

很多在此期间发生了变化,创建了更多的mashup示例。其中最重要的是Cory Cowgill的“SF Bus Radar”(githubyoutube)应用程序(我认为是在Dreamforce'11上创建的)。

尽管如此 - 这是我更新的服务器端地理编码示例,Geolocation类型的新字段以及JSON解析器的使用。

它尝试将地理编码结果缓存在联系人记录中。请记住,它可能不是“生产就绪”(没有Google Business API密钥=因为我们的所有请求都来自同一Salesforce IP服务器池there might be error messages)。这就是为什么我也离开了客户端地理编码。


在检查之前,您需要在环境中进行2次更改:

  1. 添加指向Remote Site Setting的“https://maps.googleapis.com”以启用Apex的标注
  2. 在设置中添加字段“位置” - >自定义 - >联系人 - >领域。类型应为“地理位置”。我选择显示为小数和6位小数的精度。

    public with sharing class mapController {
    public String searchText {get;set;}
    public List<Contact> contacts{get; private set;}
    
    public static final String GEOCODING_URI_BASE = 'https://maps.googleapis.com/maps/api/geocode/json?sensor=false&address=';
    
    // For purposes of this demo I'll geocode only couple of addresses server-side. Real code can use the commented out value.
    public static final Integer MAX_CALLOUTS_FROM_APEX = 3; // Limits.getLimitCallouts()
    
    public mapController(){
        searchText = ApexPages.currentPage().getParameters().get('q');
    }
    
    public void find() {
        if(searchText != null && searchText.length() > 1){
            List<List<SObject>> results = [FIND :('*' + searchText + '*') IN ALL FIELDS RETURNING 
                Contact (Id, Name, Email, Account.Name,
                    MailingStreet, MailingCity, MailingPostalCode, MailingState, MailingCountry, 
                    Location__Latitude__s, Location__Longitude__s)
                ];
            contacts = (List<Contact>)results[0];
            if(contacts.isEmpty()){
                ApexPages.addMessage(new ApexPages.Message(ApexPages.Severity.INFO, 'No matches for "' + searchText + '"'));
            } else {
                serverSideGeocode();
            }
        } else {
            if(contacts != null) {
                contacts.clear();
            }
            ApexPages.addMessage(new ApexPages.Message(ApexPages.Severity.INFO, 'Please provide at least 2 characters for the search.'));
        }
    }
    
    public void clearGeocodedData(){
        for(Contact c : contacts){
            c.Location__Latitude__s = c.Location__Longitude__s = null;
        }
        Database.update(contacts, false);
        contacts.clear();
    }
    
    public String getContactsJson(){
        return JSON.serialize(contacts);
    }
    public String getDebugContactsJson(){
        return JSON.serializePretty(contacts);
    }
    
    private void serverSideGeocode(){
        List<Contact> contactsToUpdate = new List<Contact>();
        Http h = new Http();  
        HttpRequest req = new HttpRequest();
        req.setMethod('GET'); 
        req.setTimeout(10000);
    
        for(Contact c : contacts){
            if((c.Location__Latitude__s == null || c.Location__Longitude__s == null)){
                String address = c.MailingStreet != null ? c.MailingStreet + ' ' : '' +
                    c.MailingCity != null ? c.MailingCity + ' ' : '' +
                    c.MailingState != null ? c.MailingState + ' ' : '' +
                    c.MailingPostalCode != null ? c.MailingPostalCode + ' ' : '' +
                    c.MailingCountry != null ? c.MailingCountry : '';
                if(address != ''){
                    req.setEndpoint(GEOCODING_URI_BASE + EncodingUtil.urlEncode(address, 'UTF-8'));
                    try{
                        HttpResponse res = h.send(req);
                        GResponse gr = (GResponse) JSON.deserialize(res.getBody(), mapController.GResponse.class);
                        if(gr.status == 'OK'){
                            LatLng ll = gr.results[0].geometry.location;
                            c.Location__Latitude__s = ll.lat;
                            c.Location__Longitude__s = ll.lng;
                            contactsToUpdate.add(c);
                        } else {
                            ApexPages.addMessage(new ApexPages.Message(ApexPages.Severity.ERROR, 'Geocoding of "' + address + '" failed:' + gr.status));
                        }
                    }catch(Exception e){
                        ApexPages.addMessages(e);
                    }
                }
                // Bail out if we've reached limit of callouts (not all contacts might have been processed).
                if(Limits.getCallouts() == MAX_CALLOUTS_FROM_APEX) {
                    break;
                }
            }
        }
        if(!contactsToUpdate.isEmpty()) {
            Database.update(contactsToUpdate, false); // some data in Developer editions is invalid (on purpose I think).
            // If update fails because "j.davis@expressl&amp;t.net" is not a valid Email, I want the rest to succeed
        }
    }
    
    // Helper class - template into which results of lookup will be parsed. Some fields are skipped!
    // Visit https://developers.google.com/maps/documentation/geocoding/#Results if you need to create full mapping.
    public class GResponse{
        public String status;
        public GComponents[] results;
    }
    public class GComponents{
       public String formatted_address;
       public GGeometry geometry;
    }
    public class GGeometry {
        public LatLng location;
    }
    public class LatLng{
        public Double lat, lng;
    }
    }
    

  3. <apex:page controller="mapController" tabStyle="Contact" action="{!find}" id="page">
        <head>
            <style>
                div #map_canvas { height: 400px; }
            </style>
            <script type="text/javascript" src="https://maps.googleapis.com/maps/api/js?sensor=false"></script>
        </head>
        <apex:sectionHeader title="Hello StackOverflow!" subtitle="Contact full text search + Google Maps integration" />
        <apex:pageMessages />
        <apex:form id="form">
            <apex:pageBlock id="searchBlock">
                <apex:inputText value="{!searchText}" />
                <apex:commandButton value="Search" action="{!find}"/>
                <p>Examples: <a href="/apex/{!$CurrentPage.Name}?q=USA">"USA"</a>, "Singapore", "Uni", "(336) 222-7000". If it works in the global search box, it will work here.</p>
            </apex:pageBlock>
            <apex:pageBlock title="Found {!contacts.size} Contact(s)..." rendered="{!NOT(ISNULL(contacts)) && contacts.size > 0}" id="resultsBlock">
                <apex:pageBlockButtons location="top">
                    <apex:commandButton value="Clear cached locations" title="Click if you want to set 'null' as geolocation info for all these contacts" action="{!clearGeocodedData}" />
                </apex:pageBlockButtons>
                <apex:pageBlockTable value="{!contacts}" var="c" id="contacts">
                    <apex:column headerValue="{!$ObjectType.Contact.fields.Name.label}">
                        <apex:outputLink value="../{!c.Id}">{!c.Name}</apex:outputLink>
                    </apex:column>
                    <apex:column headerValue="Address">
                        {!c.MailingStreet} {!c.MailingCity} {!c.MailingCountry}
                    </apex:column>
                    <apex:column value="{!c.Account.Name}"/>
                    <apex:column headerValue="Location (retrieved from DB or geocoded server-side)">
                        {!c.Location__Latitude__s}, {!c.Location__Longitude__s}
                    </apex:column>
                </apex:pageBlockTable>
                <apex:pageBlockSection columns="1" id="mapSection">
                    <div id="map_canvas" />
                </apex:pageBlockSection>
                <apex:pageBlockSection title="Click to show/hide what was geocoded server-side and passed to JS for further manipulation" columns="1" id="debugSection">
                    <pre>{!debugContactsJson}</pre>
                </apex:pageBlockSection>
                <pre id="log"></pre>
            </apex:pageBlock>
        </apex:form>
        <script type="text/javascript">
        twistSection(document.getElementById('page:form:resultsBlock:debugSection').childNodes[0].childNodes[0]); // initially hide the debug section
    
        var contacts = {!contactsJson};    // Array of contact data, some of them might have lat/long info, some we'll have to geocode client side
        var coords = [];                   // Just the latitude/longitude for each contact
        var requestCounter = 0;
    
        var markers = [];                  // Red things we pin to the map.
        var balloon = new google.maps.InfoWindow(); // Comic-like baloon that floats over markers.
    
        function geocodeClientSide() {
            for(var i = 0; i < contacts.length; i++) {
                if(contacts[i].Location__Latitude__s != null && contacts[i].Location__Longitude__s != null) {
                    coords.push(new google.maps.LatLng(contacts[i].Location__Latitude__s, contacts[i].Location__Longitude__s));
                } else {
                    ++requestCounter;
                    var address = contacts[i].MailingStreet + ' ' + contacts[i].MailingCity + ' ' + contacts[i].MailingCountry;
                    var geocoder = new google.maps.Geocoder();
                    if (geocoder) {
                        geocoder.geocode({'address':address}, function (results, status) {
                            if (status == google.maps.GeocoderStatus.OK) {
                                coords.push(results[0].geometry.location);
                            } else {
                                var pTag = document.createElement("p");
                                pTag.innerHTML = status;
                                document.getElementById('log').appendChild(pTag);
                            }
                            if(--requestCounter == 0) {
                                drawMap();
                            }
                        });
                    }
                }
            }
            // It could be the case that all was geocoded on server side (or simply retrieved from database).
            // So if we're lucky - just proceed to drawing the map.
            if(requestCounter == 0) {
                drawMap();
            }
        }
    
        function drawMap(){
            var mapOptions = {
                center: coords[0],
                zoom: 3,
                mapTypeId: google.maps.MapTypeId.ROADMAP
            };
            var map = new google.maps.Map(document.getElementById("map_canvas"),  mapOptions);
    
            for(var i = 0; i < coords.length; ++i){
                var marker = new google.maps.Marker({map: map, position: coords[i], title:contacts[i].Name, zIndex:i});
    
                google.maps.event.addListener(marker, 'click', function() {
                    var index = this.zIndex;
                    balloon.content = '<b>'+contacts[index].Name + '</b><br/>' + contacts[index].Account.Name + '<br/>' + contacts[index].Email;
                    balloon.open(map,this);
                });
                markers.push(marker);
            }
        }
    
        geocodeClientSide();
        </script>
    </apex:page>
    

答案 1 :(得分:1)

另一个值得关注的地方是force.com平台基础book(如果您没有开发者帐户,则为site)。他们有一个非常好的详细教程here,展示了如何将地图与Salesforce集成(他们使用Yahoo作为教程,但它也可以与Google Maps一起使用)。

答案 2 :(得分:1)

从Spring&#39; 15开始,我们也可以使用apex:map而无需额外的Google API。 在Lightning中观看时也有效 - 没有具体的个人经历,但这是我读过的。

文档示例:

<apex:map width="600px" height="400px" mapType="roadmap" center="{!Account.BillingStreet}, {!Account.BillingCity}, {!Account.BillingState}">
      <!-- Add a CUSTOM map marker for the account itself -->
      <apex:mapMarker title="{! Account.Name }" position="{!Account.BillingStreet}, {!Account.BillingCity}, {!Account.BillingState}" icon="{! URLFOR($Resource.MapMarkers, 'moderntower.png') }"/>

      <!-- Add STANDARD markers for the account's contacts -->
      <apex:repeat value="{! Account.Contacts }" var="ct">

        <apex:mapMarker title="{! ct.Name }" position="{! ct.MailingStreet }, {! ct.MailingCity }, {! ct.MailingState }"></apex:mapMarker>

      </apex:repeat>
</apex:map>

在示例中,{! Account.Contacts }是联系人列表 正在迭代。每次迭代,都会创建apex:mapMarker来映射列表中的所有联系人。尽管OP已经过时了,但搜索结果仍然是&#34;基本上可以替换在示例中迭代的{Account.Contacts}列表。

文档: Docs that example was pulled from.

(我知道这已经过时但是从更新中被带到了顶层,所以认为更新不使用API​​就行了。)